Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

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

Merge r267866 from head:
Drop references to updating over csup from build(7).

MFC r267599:

- Add a LOCAL_ITOOLS to allow adding additional tools required for the
installworld and distributeworld targets

PR: 179562

MFC r263812:

Update build(7) with LOCAL_* vars

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

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

WITH_CTF is now a "normal" build option (WITHOUT_CTF is supported and
MK_CTF is used internally).

Reviewed by: fjoe

Add reference to portsnap(8).

Submitted by: Tim Kientzle
MFC after: 1 day

Point out that /usr/src, /usr/doc, and /usr/ports may be empty or not
exist until populated with csup(1) or svn(1).

PR: 169487
Submitted by: Moritz Wilhelmy
MFC after: 1 day

Bump .Dd to reflect the date of the last content change, so MFC content
makes sense.

Pointy-hat to: gjb (myself)

Whitespace cleanup in build(7).

MFC after: 1 week
Need-MFC: 225858

Document, and provide an example for, PORTS_MODULES in build(7).

PR: 161017
Submitted by: gcooper
MFC after: 1 week

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.

Update release(7) and build(7) to reflect new release infrastructure for
the new installer.

- Add a new UNIVERSE_TARGET variable for 'make universe'. If it is set,
then that target is invoked for each architecture rather than the
default action of building world and kernels for each architecture.
- Add a 'make toolchains' wrapper which uses UNIVERSE_TARGET to build
toolchains for all architectures.
- Document JFLAG, MAKE_JUST_KERNELS, and MAKE_JUST_WORLDS variables for
'make universe'.

Reviewed by: bz
MFC after: 1 week

Back out r217734. [1]

Properly document what `make targets` is supposed to list to avoid
further confusion given the place the target sits. Should have happened
with r217125.

Requested by: imp [1]
Reviewed by: rwatson

Properly document what the top-level `make tinderbox` does.

Reviewed by: jmallett
MFC After: 3 days
X-MFC: build.7 only

Minor grammar fix.

Submitted by: arundel (via email)
Approved by: jkois (mentor)
Patch by: arundel
MFC after: 5 days

WITH_CTF can now be specified in src.conf (not recommended, there
are some problems with static executables), make.conf (would also
affect ports which do not use GNU make and do not override the
compile targets) or in the kernel config (via "makeoptions
WITH_CTF=yes").

Additional (related) changes:
- propagate WITH_CTF to module builds
- do not add -g to the linker flags, it's a noop there anyway
(at least according to the man page of ld)
- do not add -g to CFLAGS unconditionally
we need to have a look if it is really needed (IMO not) or if there
is a way to add it only when WITH_CTF is used

Note: ctfconvert / ctfmerge lines will not appear in the build output,
to protect the innocent (those which do not build with WITH_CTF would
see the shell-test and may think WITH_CTF is used).

Reviewed by: imp, jhb, scottl (earlier version)
Discussed on: arch@

Document DEBUG_FLAGS in a more visible place, in the build(7) manpage

Noticed by: Alexander Best <alexbestms.at.wwu.de>
Reviewed by: jhb
MFC after: 1 week

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.

Sort KERNFAST and KERNCONF into the list they are in.

Document KERNCONF and KERNFAST. Note that TARGET is usually all one
needs to set for cross building.

Document the NO_XXX options supported by our Makefile.inc1.

Noticed by: simon
Reviewed by: imp
MFC after: 1 week

BSDMAKE isn't really needed and was removed, so remove here

Document BSDMAKE variable that was recently introduced. Also, since
RELENG_7, the way to do a cross build changed from specifying only
TARGET_ARCH (which has an ambigous mapping to TARGET) to specifying
only TARGET (which has a unique mapping to TARGET_ARCH). Update the
example to reflect this.

MFC After: 1 week (the example change only)

Spelling fixes.

Markup glitch.

Require rpc.lockd(8) only if make is running with the -j option.

Cross-reference src.conf(5).

o Replace alpha-specific DESTDIR to a sparc64 one.

Spotted by: Gennady Proskurin

o In the cross-build example replace alpha by sparc64.

Document the requirement to run rpc.lockd(8) on both client
and server when installing onto an NFS file system.

Document the public targets and make variables supported by the
build system.

Reviewed by: ru (multiple passes)

-mdoc sweep.

Replace "/etc/make.conf" with references to make.conf(5)
where applicable. The main reason for this change is that
the location of make.conf is not constant and can be
modified via __MAKE_CONF. This change also improves
hyper-text linkage in our manpages.

MFC after: 2 weeks

Add missing "not" in rev. 1.34.

Submitted by: Jeremie Le Hen

Make delete-old* and friends useable for cross-builds.

Document 'kernel-toolchain'.

Submitted by: Jeremie Le Hen <jeremie@le-hen.org>

Forced commit [1] to add another design goal which I forgot to mention in
the initial commit of the delete-old feature:

One of the design goals of the recently committed way of removing obsolete
files was to *not* remove a file which we never had in the base system (I'm
not sure I mentioned this in the commit log). So if an administrator decides
to move something to somewhere in the base system (for whatever reason), it
will stay where it is (and this is good, since this move was done with a
specific purpose).

Suggested by: Jeremie Le Hen <jeremie@le-hen.org> [1]
Approved by: mentor (joerg; implicit)

- Move recently added dir into the correct section.
- Add a note about the organisation of the sections.
- Expand shell globs (they worked in a previous version of the delete-old
target, but not in this one).
- Use the correct way of checking for a native environment. [1]
- Add some more obsolete files.
- Fix some bad english. [1]

Suggested by: ru [1]
Approved by: mentor (joerg)

Add delete-old and delete-old-libs targets:
- removes obsolete files/dirs or libraries.
- works in interactive (default) and batch mode
- respects DISTDIR
- documented in UPDATING and build(7)

The head of the file ObsoleteFiles.inc contains instructions how to add
obsolete files/dirs/libs to the list. Obviously one should add obsolete
files to this list, when he removes a file/dir/lib from the basesystem.

Additionally add check-old target:
- allows re@ to check if a file on the obsolete list resurfaces

Design goals:
- allows full control by the user (default interactive mode)
- possibility of scripted removal of obsolete files (batch mode)
- opt-in removal of files (explicit list of files)
- seperate removal of libs (2 delete targets)

Important design decissions:
- structured list of files to remove instead of a plain text file:
* allows to remove additional files if a NO_foo knob is specified
without the need to change the targets (no NO_foo knob is respected
yet)
- not using mtree like NetBSD does:
* mtree doesn't has an interactive mode

Discussed on: arch (long ago), current (this year)
Additional input from: re (hrs)
Approved by: mentor (joerg)

Fix a few markup nits in previous commit.

Noticed by: ru, who else? :)

Previous commit missed the following:

PR: 76064
Submitted by: Gavin Atkinson <gavin.atkinson@ury.york.ac.uk> (original version)
Reviewed by: keramida (follow-up in the PR)

To be more complete, discuss 'make kernel' since we do cover buildkernel.
Xref config.8.
Bump doc date.

Replaced a way outdated and unsafe sequence of upgrading the system
from sources with the link to the relevant section in src/UPDATING.

Remove another mention of "make world".

Assorted markup, spelling, and grammar fixes.

mdoc(7) janitor:
- Use .Aq macro instead of <foo>.
- Kill EOL whitespace.

Amplify the reboot requirement

Add required reboot into single-user mode step.
# mdoc janitors should make sure I did the markup right

Inspired by: recent problems in this area

Bring build(7) in sync with src/Makefile by removing documentation
for targets that have been unsupported since April:
- upgrade
- aout-to-elf
- aout-to-elf-build
- aout-to-elf-install
- move-aout-libs

Approved by: imp

mdoc(7) police: tidy up.

Spell analogous properly.

Found by: ispell(1)

Markup fix. Use .Va instead of .Ev. No content changes.

Add a description of the TARGET variable, and add more information
about the TARGET_ARCH variable. (1)

Add information about the DESTDIR variable.

Add more examples for cross-building.

(1) Submitted by: ru
MFC after: 3 days

Add an ENVIRONMENT section, and document TARGET_ARCH and NO_WERROR.
Add a cross-build example.

Reference release(7) in SEE ALSO.

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.

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: removed HISTORY info from the .Os call.

Replace references to the KERNEL variable with KERNCONF.

mdoc(7) police: normalize .Nd.

Prepare for mdoc(7)NG.

mdoc(7) police: removed duplicate .Os calls.

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

Mention mergemaster(8).

Submitted by: obrien

Use a more generic name for the compiler cross-reference. (cc instead of
gcc.)

Suggested by: sheldonh (not sholdonh)

* Say that ps, top, etc, "may not work" with the new kernel, rather than
"will not work", as in many cases they will.

Suggested by: sholdonh

* Add cross-references to reboot(8) and shutdown(8)

Add an example to explain the basic procedure to build the world.

Suggested by: obrien

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