MFC r266416:

------------------------------------------------------------------------
    r266416 | bjk | 2014-05-18 17:05:54 -0400 (Sun, 18 May 2014) | 14 lines

    Document some user-settable make variables in ports.7

    This is not a comprehensive list, as the variables themselves are spread
    out over multiple files, but it is a start.

    Add a section to make.conf noting that variables may be set there that
    affect ports builds, but refer to ports.7 and elsewhere for the actual
    listing; any listing in make.conf.5 would likely become out of date
    fairly quickly.

    PR:             docs/189199
    Reviewed by:    bdrewery (previous version)
    Approved by:    hrs (mentor)

    ------------------------------------------------------------------------

PR:		189199
Approved by:	hrs (mentor)
This commit is contained in:
bjk 2014-06-09 23:11:50 +00:00
parent b02f5696fa
commit bc20a2fb62
2 changed files with 48 additions and 1 deletions

View File

@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd May 2, 2014
.Dd May 17, 2014
.Dt MAKE.CONF 5
.Os
.Sh NAME
@ -655,6 +655,14 @@ for simple printers, or
for postscript or graphics printers with a ghostscript
filter, or both.
.El
.Ss "BUILDING PORTS"
Several make variables can be set that affect the building of ports.
These variables and their effects are documented in
.Xr ports 7 ,
.Pa ${PORTSDIR}/Mk/*
and the
.Fx
Porter's Handbook.
.Sh FILES
.Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact
.It Pa /etc/make.conf

View File

@ -486,6 +486,44 @@ have been configured will have a uniquely named sub-directory, containing a
single file
.Pa options .
.El
.Sh MAKE VARIABLES
The following list provides a name and short description for many of the
variables that are used when building ports.
More information on these and other related variables may be found in
.Pa ${PORTSDIR}/Mk/*
and the
.Fx
Porter's Handbook.
.Bl -tag -width ".Va OVERRIDE_LINUX_BASE_PORT"
.It Va WITH_OPENSSL_PORT
.Pq Vt bool
If set, causes ports that make use of OpenSSL to use the OpenSSL from
ports
.Pq if available
instead of the OpenSSL from the base system.
.It Va WITH_DEBUG
.Pq Vt bool
If set, debugging symbols are installed for ports binaries.
.It Va WITH_DEBUG_PORTS
A list of origins for which to set
.Va WITH_DEBUG_PORTS .
.It Va WITH_SSP_PORTS
.Pq Vt bool
If set, enables
.Fl fstack-protector
for most ports.
.It Va WITH_GHOSTSCRIPT_VER
If set, the version of ghostscript to be used by ports.
.It Va OVERRIDE_LINUX_BASE_PORT
The default linux base to use.
.It Va WITH_CCACHE_BUILD
.Pq Vt bool
If set, enables the use of
.Xr ccache 1
for building ports.
.It Va CCACHE_DIR
Which directory to use for the ccache data.
.El
.Sh FILES
.Bl -tag -width ".Pa /usr/ports/Mk/bsd.port.mk" -compact
.It Pa /usr/ports
@ -495,6 +533,7 @@ The big Kahuna.
.El
.Sh SEE ALSO
.Xr make 1 ,
.Xr make.conf 5 ,
.Xr pkg 8 ,
.Xr portsnap 8
.Pp