diff options
author | Jason McIntyre <jmc@cvs.openbsd.org> | 2003-06-06 13:44:31 +0000 |
---|---|---|
committer | Jason McIntyre <jmc@cvs.openbsd.org> | 2003-06-06 13:44:31 +0000 |
commit | cde7669dfac614c3257585d7bf70fc79a0695869 (patch) | |
tree | 6dfe6728313ff22cb63f452abd8648fa7a206325 /share/man/man7/ports.7 | |
parent | 79ca0bc1355b06fab66aa313da8c8a079b16be0c (diff) |
- section reorder
- macro fixes
- kill whitespace at EOL
Diffstat (limited to 'share/man/man7/ports.7')
-rw-r--r-- | share/man/man7/ports.7 | 52 |
1 files changed, 27 insertions, 25 deletions
diff --git a/share/man/man7/ports.7 b/share/man/man7/ports.7 index 9d3cca11c2f..43a236e8b41 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.33 2003/04/15 07:02:40 david Exp $ +.\" $OpenBSD: ports.7,v 1.34 2003/06/06 13:44:30 jmc Exp $ .\" $FreeBSD: ports.7,v 1.7 1998/06/23 04:38:50 hoek Exp $ .\" .Dd January 25, 1998 @@ -128,9 +128,11 @@ line, e.g., to avoid stopping after each problem. .Ed .Pp The targets that do this are -.Ar build , checksum , clean , configure , extract , fake, fetch , -.Ar install , distclean , deinstall, reinstall, mirror-distfiles, obj , -.Ar package , cdrom-packages , link-categories, unlink-categories , +.Ar build , checksum , clean , configure , +.Ar extract , fake , fetch , install , +.Ar distclean , deinstall , reinstall , mirror-distfiles , +.Ar obj , package , cdrom-packages , link-categories , +.Ar unlink-categories , and .Ar ftp-packages . .Pp @@ -264,14 +266,14 @@ If and .Ev BULK are set to -.Sq Yes +.Sq Yes for a package build, some shortcuts are taken to allow cleaning up working directories on the fly. .Pp Some important caveats apply: -the packages already built in the package repository are assumed to be -up-to-date (BIN_PACKAGES), the database of installed packages is assumed -to be accurate (TRUST_PACKAGES), and the bulk cookies are assumed to be +the packages already built in the package repository are assumed to be +up-to-date (BIN_PACKAGES), the database of installed packages is assumed +to be accurate (TRUST_PACKAGES), and the bulk cookies are assumed to be up-to-date (BULK). .Pp This means that newer iterations of package buildings should make sure @@ -309,27 +311,27 @@ Go to this site first for all files. The .Ox ports tree comes with a mechanism called -.Ic FLAVORS. +.Ic FLAVORS . Thanks to this mechanism, users can select specific options provided by a given port. .Pp -If a port is "flavored", there should be a terse description of +If a port is "flavored", there should be a terse description of available flavors in the .Pa pkg/DESCR file. .Pp For example, the shells/bash port comes with a flavor called -.Ic static. +.Ic static . This changes the building process so a statically compiled version of -the program will be built. -To avoid confusion with other packages or flavors, +the program will be built. +To avoid confusion with other packages or flavors, the package name will be extended with a dash-separated list of the selected flavors. .Pp In this instance, the corresponding package will be called .Ic bash-1.14.7p1-static . .Pp -To build a port with a specific flavor, just pass +To build a port with a specific flavor, just pass .Ev FLAVOR in the environment of the .Xr make 1 @@ -358,7 +360,7 @@ combinations, when such combinations do not make sense. Lots of ports can be built without X11 requirement and accordingly have a .Ic no_x11 -flavor. +flavor. .Pp Flavor settings are not propagated to dependencies. If a specific combination is needed, careful hand-building of the @@ -381,7 +383,7 @@ should not be changed by the user, and are liable to change without notice. .It Ev PORTSDIR Location of the ports tree .Po -usually +usually .Pa /usr/ports .Pc .It Ev DISTDIR @@ -406,10 +408,10 @@ Directory to put the package in. The full path to the package. .El .It Ev BULK_COOKIES_DIR -During bulk package building, used to store cookies for already built -packages to avoid rebuilding them, since the actual -working directory will already have been cleaned out. -Defaults to bulk/${MACHINE_ARCH} under +During bulk package building, used to store cookies for already built +packages to avoid rebuilding them, since the actual +working directory will already have been cleaned out. +Defaults to bulk/${MACHINE_ARCH} under .Ev PORTSDIR . .It Ev LOCALBASE Where to install things in general @@ -493,11 +495,6 @@ Ports Mechanism: http://www.openbsd.org/ports.html The .Ox Porting Checklist: http://www.openbsd.org/checklist.html -.Sh AUTHORS -This man page was originated by -David O'Brien, from the -.Fx -project. .Sh HISTORY .Nm The Ports Collection appeared in @@ -508,6 +505,11 @@ by Ejovi Nuwere, with much initial effort by Angelos D. Keromytis. Maintenance passed then to Marco S. Hyman, and then to Christopher Turan. It is currently managed by Marc Espie, Brad Smith, and Christian Weisgerber, along with a host of others found at ports@openbsd.org. +.Sh AUTHORS +This man page was originated by +David O'Brien, from the +.Fx +project. .Sh BUGS Ports documentation is split over several places --- .Xr bsd.port.mk 5 , |