d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document some user-settable make variables in ports.7

Browse Source 
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)
This commit is contained in:
bjk 2014-05-18 21:05:54 +00:00
parent e860f4779d
commit 7902ae2a42
2 changed files with 49 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
share/man/man5/make.conf.5
View File

@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd May 2, 2014
.Dd May 17, 2014
.Dt MAKE.CONF 5
.Os
.Sh NAME
@ -658,6 +658,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

41
share/man/man7/ports.7
View File

@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd November 18, 2012
.Dd May 17, 2014
.Dt PORTS 7
.Os
.Sh NAME
@ -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