MULTI_PACKAGES for users.

from Michael Coulter <mjc@bitz.ca>, thanks!

1 files changed, 37 insertions, 1 deletions

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-<version> and mysql-server-<version> .
+.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