From ab5125e110d669f4ecd17be205d2235ecdaa8466 Mon Sep 17 00:00:00 2001 From: Marc Espie Date: Thu, 22 Jan 2004 21:07:11 +0000 Subject: MULTI_PACKAGES for users. from Michael Coulter , thanks! --- share/man/man7/ports.7 | 38 +++++++++++++++++++++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) (limited to 'share/man/man7') diff --git a/share/man/man7/ports.7 b/share/man/man7/ports.7 index 925a0883546..201fb17c183 100644 --- a/share/man/man7/ports.7 +++ b/share/man/man7/ports.7 @@ -23,7 +23,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $OpenBSD: ports.7,v 1.40 2003/09/03 09:10:30 jmc Exp $ +.\" $OpenBSD: ports.7,v 1.41 2004/01/22 21:07:10 espie Exp $ .\" $FreeBSD: ports.7,v 1.7 1998/06/23 04:38:50 hoek Exp $ .\" .Dd January 25, 1998 @@ -379,6 +379,42 @@ flavor. Flavor settings are not propagated to dependencies. If a specific combination is needed, careful hand-building of the required set of packages is still necessary. +.Sh MULTI_PACKAGES +The +.Ox +ports tree comes with a mechanism called +.Ic MULTI_PACKAGES. +This mechanism is used when a larger package is broken down into +several smaller components referred to as subpackages. +.Pp +If a port is "subpackaged", in addition to the main package, each +subpackage will have a corresponding description in the +.Pa pkg/DESCR-subpackage +file. +.Pp +For example, the database/mysql port comes with subpackages called +.Ic tests +and +.Ic server . +.Pp +In this instance, the build will yield multiple packages, one +corresponding to each subpackage. In the case of our mysql example, +the subpackages will be called +.Ic mysql-tests- and mysql-server- . +.Pp +To install/deinstall a specific subpackage of a port, you may +.Xr pkg_add 1 +them manually, or alternatively, you may set +.Ev SUBPACKAGE +in the environment of the +.Xr make 1 +command during the install/deinstall phase: +.Pp +.Bd -literal -offset indent +$ env SUBPACKAGE="-server" make install +$ env SUBPACKAGE="-server" make deinstall +.Ed +.Pp .Sh PORT VARIABLES These can be changed in the environment, or in .Pa /etc/mk.conf -- cgit v1.2.3