Copy stable/9 to releng/9.3 as part of the 9.3-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

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: re (gjb), hrs (mentor)

MRC r265230:
Clarify that MAKEOBJDIRPREFIX and MAKEOBJDIR are not
honored as make(1) arguments.

Sponsored by: The FreeBSD Foundation

MFC r230786, r246283, r251084, r251085, r251086:

r230786 (imp):
- Allow specification of build shell for the buildenv target.

r246283 (hrs) (partial):
- Add {WORLD,KERNEL}_FLAGS to [BTWK]MAKE.

r251084:
- r245757 introduced warning output if update method is set to
CVS_UPDATE or SUP_UPDATE.
- CVS exporter for stable/9/ is turned off for nearly one month
now.
- It is finally time to swing the ax at these update methods.

r251085:
- Fix typo introduced in r251084.

r251086:
- Remove references to CVS_UPDATE and SUP_UPDATE to catch up
with r251084.

Approved by: kib (mentor)

MFH (r248617): retire the mislabeled ENABLE_SUID_SSH knob.

MFC r249952:

Fix examples for overriding INSTALL to not suggest hardcoding
'install' since it breaks buildworld after the introduction and
use of 'install -l' in r245752. Overriding INSTALL causes
/usr/bin/install to be used instead of the proper
/usr/src/tools/install.sh which handles the new flag.

MFC r240252, r241541, r241543, r245756:

r240252: (eadler)
- Remove documentation and www cvsup files as they are no longer
useful with the switch to subversion.

r241541: (joel)
- Minor mdoc improvements. Also remove unnecessary csup reference.

r241543: (eadler)
- Bump .Dd

r245756:
- Mark SUP_UPDATE as deprecated in make.conf(5), providing
instructions to use SVN_UPDATE or freebsd-update(8).
- While here, remove bogus NO_WWWUPDATE.

MFC r241542:
Don't document the PORTSSUPFILE variable. Even though this still works,
try to discourage users from depending on it.

Approved by: cperciva (implicit)

MFC r235337:

General mdoc(7) and typo fixes.

PR: 167804

MFC r234935:
Prefer the use of csup to cvsup when talking about the binary.

PR: docs/167459
Approved by: cperciva (implicit)

MFC r228418, 228419:

r228418:
- Document the SVN variable needs to be set in make.conf(5) when
SVN_UPDATE is set [1]

r228419:
- Minor whitespace cleanup to make.conf(5)

PR: 163162 [1]

Copy head to stable/9 as part of 9.0-RELEASE release cycle.

Approved by: re (implicit)

It's a bit odd, but "make update" in src/ can also update the ports/,
doc/, and now www/ trees, but only using the "cvsup" transport.

When "make update" is run using a tree's makefile, it can also use
"cvs" (except for www/) and "svn" (only src/).

Clean up documentation and code regarding "make update":

- Increase oddness by adding support for WWWSUPFILE and NO_WWWUPDATE to
Makefile.inc1 (analogous to PORTSSUPFILE/NO_PORTSUPDATE and
DOCSUPFILE/NO_DOCUPDATE; WWWSUPFILE already supported by www/Makefile).

- Document all trees that support CVS_UPDATE.

- Document all trees that support SUP_UPDATE.

- Document SVN_UPDATE.

- Document NO_WWWUPDATE.

- make.conf(5) mistakenly said that *SUPFILE* had defaults.

- Add an example entry for WWWSUPFILE.

mdoc: drop redundant .Pp and .LP calls

They have no effect when coming in pairs, or before .Bl/.Bd

mdoc: move CAVEATS, BUGS and SECURITY CONSIDERATIONS sections to the
bottom of the manpages and order them consistently.

GNU groff doesn't care about the ordering, and doesn't even mention
CAVEATS and SECURITY CONSIDERATIONS as common sections and where to put
them.

Found by: mdocml lint run
Reviewed by: ru

Forgot to bump .Dd, so do it with this commit. Chose local time over
UTC time for the date...

Docmuent NO_KERNEL{CLEAN,CONFIG,DEPEND,OBJ} as necessary. Update
documentation on KERNFAST meaning.

Document the WWWSUPFILE variable.

PR: 137723
Submitted by: Sofian Brabez <sbrabez at gmail dot com>
Approved by: imp (mentor, implicit)
MFC after: 3 days
Facilitated by: Snow B.V.

o Document MALLOC_PRODUCTION knob.

PR: docs/136029
Submitted by: anonymous
MFC after: 2 weeks

You can never have enough documentation.

Document the SENDMAIL_ALIASES, SENDMAIL_MAP_SRC, SENDMAIL_MAP_TYPE, and
SENDMAIL_START_SCRIPT
.Xr make.conf 5
variables.
These are used in
.Pa /etc/mail/Makefile .

PR: conf/40548
MFC after: 3 days

Add LOADER_FIREWIRE_SUPPORT knob.

Requested by: ru

Markup fixes.

- Move descriptions of BOOT_COMCONSOLE_PORT, BOOT_COMCONSOLE_SPEED,
and LOADER_TFTP_SUPPORT options into the world section since boot
blocks are built as part of the world.

- Document BOOT_PXELDR_ALWAYS_SERIAL and BOOT_PXELDR_PROBE_KEYBOARD
options of pxeboot(8).

MFC after: 3 days

Remove reference to Alpha

Refer to csup in the make.conf(5) manpage.

Insta-MFC to follow.

Reminded by: ru (some time ago)

Remove mentions of old compat options from here; equivalents are
now provided in src.conf(5).

Mention NO_NLS_CATALOGS.

Suggested by: Niclas Zeising <lothrandil__at__n00b.apagnu.se>

NO_WPA_SUPPLICANT_EAPOL is a bool, not a str

Change default build of wpa_supplicant to include EAPOL support;
ENABLE_WPA_SUPPLICANT_EAPOL is no more, now use NO_WPA_SUPPLICANT_EAPOL
to build with only WPA-PSK support.

Reviewed by: ru, bsdimp (basic approach)
MFC after: 1 week

Document NO_AUDIT make variable.

Obtained from: TrustedBSD Project

Correct the meaning of the NO_SHARED knob.

MFC after: 3 days

Remove usbd(8) and all references to it. It is no longer necessary
since devd(8) now provides the same functionality.

Submitted by: Anish Mistry

Reorder the variable lists on this page alphabetically by make variable
name.

Discussed with: ru

- Move the documentation for the ENABLE_WPA_SUPPLICANT_EAPOL knob to into
the list for 'world' builds.
- Increase the width of a bullet list.
- Use .Ss to name sub-sections of this file.

-mdoc sweep.

A better, more correct explination of NO_SHARED. This could probably
use a quick touch up, but at least it's correct.

Requested by: ru

Document that changes to nsswitch.conf might be needed when
compiling with NO_NIS.

PR: bin/87221
Reviewed by: simon
MFC after: 4 weeks

Clarify the usage and effects of sys.mk, make.conf(5), and __MAKE_CONF.

MFC after: 2 weeks

document ENABLE_WPA_SUPPLICANT_EAPOL

Approved by: re (scottl)

Use 'manual page' instead of 'man page' for consistency.

Approved by: re (hrs)

Add NO_DICT handle. Saves almost 3.5 MB installed.

Document NO_RCMDS, bump doc date.

Document NO_GPIB

Document NO_NETCAT.

Fixes to previous revision:

- bump document date
- break hard sentence break
- remove whitespace at EOL

Document the shiny new WITHOUT_MODULES knob in make.conf.

PR: kern/76225
Prodded by: ru@, brueffer@
MFC after: 2 weeks

NOCLEAN -> NO_CLEAN
NOCLEANDIR -> NO_CLEANDIR

NOSHARE -> NO_SHARE

Overhaul ppp(8) build options so they are safe to use in
/etc/make.conf:

NOALIAS -> retired (support provided by PPP_NO_NAT)
NOATM -> PPP_NO_ATM (also subject to NO_ATM global)
NODES -> PPP_NO_DES (support was broken, now recovered)
NOI4B -> PPP_NO_I4B (also subject to NO_I4B global)
NOKLDLOAD -> PPP_NO_KLDLOAD
NONAT -> PPP_NO_NAT
NONETGRAPH -> PPP_NO_NETGRAPH
NOPAM -> PPP_NO_PAM (will be subject to NO_PAM global)
NORADIUS -> PPP_NO_RADIUS
NOSUID -> retired (support provided by PPP_NO_SUID)
PPP_NOSUID -> PPP_NO_SUID

NOINET6 -> NO_INET6

NOGAMES -> NO_GAMES

NOCRYPT -> NO_CRYPT

NOSHARED -> NO_SHARED

NODOCCOMPRESS -> NO_DOCCOMPRESS
NOINFO -> NO_INFO
NOINFOCOMPRESS -> NO_INFOCOMPRESS
NOLINT -> NO_LINT
NOPIC -> NO_PIC
NOPROFILE -> NO_PROFILE

NOATM -> NO_ATM

NOLIBC_R -> NO_LIBC_R
NOLIBPTHREAD -> NO_LIBPTHREAD
NOLIBTHR -> NO_LIBTHR

Start the dreaded NOFOO -> NO_FOO conversion.

OK'ed by: core

Add options recently added to make.conf.

Document NO_NIS variable.

Submitted by: Pawel Worach <pawel dot worach at telia dot com>
Approved by: rwatson (mentor)
MFC after: 1 week

Document PORTS_MODULES variable.

Remove references to NO_VINUM

Overdue removal of COMPAT* knobs.

1. Incorporate most of Ruslan's improvements to where and how the
/etc/namedb symlink is created.

2. Incorporate Brian's suggestion to make the link relative. This
is necessary to handle situations (such as mergemaster) where the
user is building a tree in a seperate environment. This will also
fix the problem with the way DESTDIR is set in 'make release'.

3. Add a new knob, NO_BIND_MTREE, as suggested by the folks who
already have stuff in /var/named that they don't want me to mess with.

4. Update make.conf(5) with the new stuff, and correct a few paths
that have changed since I last updated it.

1. Add much finer granularity to the NO_BIND knobs with the addition of:
NO_BIND_DNSSEC, NO_BIND_ETC, NO_BIND_NAMED, and NO_BIND_UTILS.

2. Make creation of directories in /usr/include that are only needed
in the WITH_BIND_LIBS case conditional.

Reviewed by: ru, des

Bump document date.

Fix the WANT_BIND_LIBS knob by correctly spelling it as WITH_BIND_LIBS
to match how similar syntax is used in the ports system. Thanks to kris
for pointing out my mistake here.

Install the lwres library unless the user defines NO_BIND, or the new
knob, NO_BIND_LIBS_LWRES. There is at least one potential customer
for this library in the wings. Thanks to nectar for the reminder.

Break the NO_BIND knob out from the pack, and begin documenting
the finer granularity for the various BIND features.

Bump document date.

Reminded by: ru

Document NO_PF and NO_AUTHPF

MFC after: 3 days

Add a NO_BOOT knob to prevent building the boot blocks and loader.

Reviewed by: ru
MFC after: 3 days

Yet another place where we can document that MAKEOBJDIRPREFIX and
MAKEOBJDIR are, and have always been, environment variables.

Requested by: kris

Removed remnants of ports-related knobs from here.

mdoc(7) fixes.

We support -O2 now.

Assorted markup, spelling, and grammar fixes.

Remove mention of doscmd.

WANT_EXT2FS_MODULE was removed from sys/modules/Makefile in rev 1.366.
Hence, remove it here as well.

Document NO_BLUETOOTH knob

Reviewed by: imp (mentor), ru

Document NO_DYNAMICROOT.

Reviewed by: gordon

Turn SENDMAIL_CF_DIR into an officially supported make.conf variable
and use it in src/etc/sendmail/Makefile in case the user wants to use
a different path to the sendmail m4 sources (e.g., sendmail port users).

Submitted by: dinoex
MFC after: 21 days
X-MFC after: RELENG_4 code freeze ends

Better explain what INSTALL="install -C" does, and warn that this may
be hardwired into makefiles, including those under /usr/share/mk.

The reporter submitted a patch, but I've watered it down.

Reported by: Ian Freislich <ianf@za.uu.net>
MFC after: 3 weeks

document various NO* options

Limit testing for an up-to-date version of make(1) to the world and
buildworld targets by default, but allow it to be done for all user
targets by introducing a boolean option, named ALWAYS_CHECK_MAKE.

This change is by no means perfect and I don't even want to claim
this to be a solution. It does however address the fact that not
everybody likes to see make(1) rebuilt simply because the regression
test failed for some reason or other, including pilot error. It
therefore serves the purpose of keeping the crowd happy until we
have something better or simply reached a compromise.

The reasons for changing the default behaviour are:
o It avoids a negative, possibly non-intuitive option,
o It's according to POLA and fond of feet,
o Only buildworld is documented to do its best to be
successful at reasonably cost.

Reviewed by: gad, imp, obrien, peter

Thanks to Ruslan's src/etc/sendmail/Makefile patch, it is now safe
(though probably not a good idea in general) to set the various
SENDMAIL_*_MC variables to /etc/mail/sendmail.mc or /etc/mail/submit.mc.

MFC after: 5 days

Document the NOLIBPTHREAD and NOLIBTHR knobs.

Unbreak world build if NO_OPENSSL is defined but NO_KERBEROS is not.

Submitted by: Marius Strobl <marius@alchemy.franken.de>
Approved by: re (jhb)

Retire the useless NOSECURE knob.

Approved by: re (scottl)

Turn MAKE_KERBEROS5 into NO_KERBEROS by negating the logic. Some extra
cleanups were necessary in release/Makefile, and the tinderbox code
was syntax checked, not run checked.

More factual updates for kerberos 5.

KerberosIV deorbit: Remove references.

Document the NOMAN option.

Install the OpenSSL man pages in /usr/share/openssl/man
and remove the WANT_OPENSSL_MANPAGES knob.

Remove MAKEDEV quirks, now obsolete.

Document WANT_EXT2FS_MODULE.

mdoc(7) police: grammar and spelling nits.

Document NO_CPU_CFLAGS && NO_CPU_COPTFLAGS in the make.conf(5) manual
page.

PR: 45418
Reviewed by: jhb (a slightly older version)

mdoc(7) police: scheduled sweep.

Approved by: re

As warned on freebsd-current@, remove the perl wrapper from /usr/src.
The /usr/bin/perl wrapper isn't solving many of the problems it was
imported to deal with. There are limitations to it that don't have a
clear "fix".

Reviewed by: markm, kris
Extorted approval from: re(jhb)

Catch the make.conf manual page up with defaults/make.conf

PR: 45470
Approved by: re (bmah)
Submitted by: Carl Schmidt <carl@slackerbsd.org> (original version)

Backout "compatibility hack" for __sF.

Requested by: Steve Kargl <sgk@troutmask.apl.washington.edu> (submitter)

Provide a hook to make __sF visible outside of libc for commercial apps
if WANT_COMPAT4_STDIO is defined when compiling libc.

Submitted by: Steve Kargl <sgk@troutmask.apl.washington.edu>

PRINTERDEVICE can now take multiple values.

Change to match NO_MAKEDEV* -> MAKEDEV*.

mdoc(7) police: nit.

Remove the reference to NOUUCP, ans we no longer have base UUCP.

Ignore -C, -p, and -S options of install(1) when used with the -d
option. Warn about COPY being phased out. Restore the old method
of always comparing before installing: INSTALL="install -C".

Requested by: bde

To force install(1) to always compare files before installing, one
now needs to set COPY=-C as -C is no longer compatible with the -d
option. It is also likely to be renamed to INSTALL_COPY soon.
Update documentation to reflect this change.

PR: bin/40724

Add a warning regarding the SENDMAIL_*_MC make.conf variable values.
Using /etc/mail/sendmail.mc will create /etc/mail/sendmail.cf during
a buildworld.

PR: misc/39397
MFC after: 3 days

Per previous discussion, and with Mark's blessing, update the value
of this knob to reflect (-)current reality.

Removed vestiges of perl(1).

mdoc(7) police: get rid of a single hard sentence break.

Document the ENABLE_SUID_NEWGRP variable.

Requested by: mike
PR: 36190

Add a new make.conf knob, SENDMAIL_MAP_PERMS, which specifies the
permissions to use for alias and map database files built by
/etc/mail/Makefile. The default is 0640 to assist users in avoiding
a file locking local denial of service.

MFC after: 1 day
pending RE approval

Removed the vestiges of NO_?PERL and ENABLE_SUIDPERL.

Spotted by: grep(1)

Grammar fix: cause -> causes.

PR: docs/38059
Submitted by: Chris Pepper <pepper@rockefeller.edu>

Turn on the set-user-ID bit for k5su if ENABLE_SUID_K5SU is defined.

Back out the NO_RCMNDS knob.
1. The committer refused to respond to questions over the commit.
2. The servers rlogind, rshd, rexecd were not wrapped.
3. "rcmnds" as an abbreviation gets an order of magnitude less hits on
Google than the much more well known "rcmds".

Provide a new make.conf knob, SENDMAIL_SUBMIT_MC to allow users to pick
the .mc file used for /etc/mail/submit.cf. By default,
/etc/mail/freebsd.submit.mc is installed and used.

Requested by: fenner
Submitted by: ume
MFC after: 1 week

${BDECFLAGS} gets added to CFLAGS, not CXFLAGS.

PR: 37032
Submitted by: Joshua Goodall <joshua@roughtrade.net>

Document NO_RCMNDS flag introduced in rev. 1.20 src/bin/Makefile.

Approved by: ru
MFC after: 1 week

Replaced hacks in sbin/Makefile,v 1.99 and usr.sbin/Makefile,v 1.217
with the NO_IPFILTER make.conf(5) knob.

(So that we can "make the-rest-of-the-world" again.)

mdoc(7) police: fix a typo in rev. 1.36 and markup nit in rev. 1.37.

Document NO_PERL.

Document new build knob, SENDMAIL_SET_USER_ID, which installs sendmail as a
set-user-ID root binary instead of the new method (set-group-ID smmsp).

Document MODULES_OVERRIDE.

PR: docs/32560
Submitted by: Maxim Konovalov <maxim@macomnet.ru>

Document COMPAT4X.

mdoc(7) police: sort FILES.

Move /etc/defaults/make.conf to /usr/share/examples/etc/make.conf as
discussed on the arch@ mailinglist (after repo-copy).

sys.mk will .error if it finds /etc/defaults/make.conf but include
it anyways (this is the same behaviour as with the make.conf.local
removal).

/usr/share/examples/etc/make.conf has BDEFLAGS commented out now,
since it's only an example file.

Adjust all textes that talk about make.conf or defaults/make.conf to
match the new situation.

Nuke all ports related options. This file has to be re-edited once
the ports-team has decided about the ports.conf issue.

The name of the kernel really isn't KERNEL now.

Submitted by: setantae@submonkey.net

The name of the kernel is KERNCONF, not KERNEL now.

When discussing optimization levels, don't put the compiler options in
.Op. None of the other manual pages do it when discussing options in
the main text, so this one shouldn't, either. Also, use .Pq instead
of another odd constructhyphenation isn't an issue here, since it's
desireable to have the contents of that digression appear together,
and it's already in another macro, anyway).

mdoc(7) police: markup nits.

Add the `WANT_FORCE_OPTIMIZATION_DOWNGRADE' knob. If set to an integer
value, it forces GCC to not optimize above this level. For intance, GCC
made with "WANT_FORCE_OPTIMIZATION_DOWNGRADE=1" is a good setting for the
Alpha platform when building ports.

mdoc(7) police: markup nits.

Fix thinko: FORCE_PKG_RESIDENT -> FORCE_PKG_REGISTER

Submitted by: Raymond Kohler <ray.kohler@mail.com>

New make knob, SENDMAIL_M4_FLAGS, modifies the flags passed to m4 when
building a .cf file from a .mc file.

Include -D_FFR_TLS_O_T to enable tls policy control since the sendmail binary
build enables that FFR as well.

PR: conf/28361
MFC after: 1 week

Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by: Silence from cvs diff -b
MFC after: 7 days

mdoc(7) police: sort xrefs.

Remove duplicate words.

Correct varuable name: WITHOUT_X --> WITHOUT_X11.

Reviewed by: ports, portmgr
Approved by: will, obrien

Document the half-supported WITHOUT_X.

PR: 27709
Submitted by: Mike Meyer <mwm@mired.org>

Add NO_I4B to avoid building/installing isdn4bsd package.

Prompted by: Alexandr Listopad <laa@laa.zp.ua>
MFC after: 3 days

Removed reference to non-existing make(7).

PR: docs/27392
Submitted by: Hendrik Scholz <hendrik@scholz.net>

mdoc(7) police: use .Va and .Vt where appropriate

Reviewed by: ru

mdoc(7) police: add missing .Pa call.

Change NO_MAKEDEV to a finer granularity method:
NO_MAKEDEV_INSTALL and NO_MAKEDEV_RUN. The former implying the latter.
The names imply what they do. The last commit by DES based on a PR defeated
the original idea behind NO_MAKEDEV, which was not to run MAKEDEV, but to do
the installation of MAKEDEV. This should satisfy both parties on the MAKEDEV
challenge.
Reflect this in the documentation.

Need one additional make.conf knob, SENDMAIL_ADDITIONAL_MC to satisfy bug
report. It allows building multiple .cf files at build time.

PR: bin/19897

Add a note indicating that SENDMAIL_MC should include the path. This is
necessary if you expect to be able to use this setting in both /etc/mail
and etc/sendmail.

Add a new make knob, SENDMAIL_MC, which is meant to replace SENDMAIL_CF as
users should be configuring via m4 now. If set, use m4 to create the .cf
file. Also, if either SENDMAIL_MC or SENDMAIL_CF is set, 'make install' or
'make distribution' in src/etc/sendmail/ will install the appropriate .cf as
/etc/mail/sendmail.cf. This fixes some mergemaster problems.

PR: conf/13016

mdoc(7) police: split punctuation characters + misc fixes.

mdoc(7) police:
Use proper macros for variables and their types, removed
hard sentence breaks, added a bunch of cross references.

document ${KERNEL}

PR: 24404
Submitted by: Mike Meyer <mwm@mired.org>

Prepare for mdoc(7)NG.

Add some text saying that this page may occasionally be out of date with the
real make.conf.

mdoc(7) police: use canonical form of .Dd macro.

Typo police.

Remove "NODESCRYPTLINKS" it has been superseeded by "passwd_format"
in /etc/login.conf.

Add two new manual pages to document the various options available in
make.conf, and the /usr/src building process.

PR: 22676
Submitted by: Mike Meyer <mwm@mired.org>
Reviewed by: nik, sheldonh