- Copy stable/10@296371 to releng/10.3 in preparation for 10.3-RC1
builds.
- Update newvers.sh to reflect RC1.
- Update __FreeBSD_version to reflect 10.3.
- Update default pkg(8) configuration to use the quarterly branch.

Approved by: re (implicit)

MFC r293281: Use standard name for ASCII LF and FF control codes

PR: 205778

MFC r287396:

It's 2015, and some people are still trying to use fdisk and then
go asking what debug flags to set for GEOM to make it work. Advice
them to use gpart(8) instead.

Something similar should probably done with disklabel,
but I need to rewrite the disklabel examples first.

Sponsored by: The FreeBSD Foundation

MFC r291891:

Use .Fx instead of explicitly spelling out FreeBSD

Fix several warnings reported by igor

Sponsored by: EMC / Isilon Storage Division

MFC r274349: Add /usr/lib/debug directory to hier(7)

The canonical standalone debug directory established by the GNU
toolchain is /usr/lib/debug, and we use it when WITH_DEBUG_FILES is set.
Mention it in the file system hierarchy page.

MFC r273955,274060,274164: Add /etc/rc.d/growfs script.

MFC r277175:

Mention /net in hier(7).

Sponsored by: The FreeBSD Foundation

MFC r277458, r277536, r277606, r277609, r277836, r277839,
r278118, r278119, r278206, r278502:

r277458:
Move virtual machine / cloud provider targets and
options from release/Makefile to their own Makefile.

Add glue to allow enabling building cloud provider VM images
by default.

Add a 'vm-cloudware' target, used to drive all targets in
CLOUDTARGETS.

Add examples for WITH_CLOUDWARE to release.conf.sample.
Add WITH_CLOUDWARE evaluation to RELEASE_RMAKEFLAGS.

Rewrite to consolidate VM image build scripts into one.

Fix duplicated mkimg(1) call in vm_create_disk().

Add primitive (untested) PowerPC/PowerPC64 VM image support.

Note: As it is currently written, the /boot/pmbr and
/boot/{gptboot,boot1.hfs} use the build host and not the
target build. Fixing this is likely going to be a hack in
itself.

mount(8) and umount(8) devfs(5) as needed.

Change path for mk-vmimage.sh from ${TARGET}/ to scripts/ now that
it is consolidated into one file.

Fix paths for the base image and output disk image files.

Set the boot partition type to 'apple-boot' for powerpc.

In vm_install_base(), copy the host resolv.conf into the build
chroot before attempting to do anything that requires working DNS
(i.e., pkg bootstrap).

In vm_extra_pre_umount(), remove the resolv.conf before the disk
image is unmounted from the backing md(4).

Silence errors when umounting the chroot's /dev, since it probably
doesn't exist when we're running this.

Unmount filesystems before attempting to destroy the md which
holds them.

Unmount filesystem and destroy md before we read the vnode from
disk and package it into a disk image. Otherwise we end up
packaging an unclean filesystem.

Merge duplicative vm-CLOUDTYPE targets before additional duplication
gets added by the impending arrival of ec2 and gcloud.

Add NOSWAP option which can be set by a vmimage.conf file to specify
that no swap space should be created in the image. This will be used
by EC2 builds, since FreeBSD/EC2 allocates swap space on "ephemeral"
disks which are physically attached to the Xen host node.

In vm_extra_install_packages(), only bootstrap pkg(8) if
VM_EXTRA_PACKAGES is empty.

In vm_extra_pre_umount(), cleanup downloaded packages if pkg(8) was
bootstrapped earlier.

In vm_extra_install_base(), do not install waagent in the openstack
image, because it is not used. This appears to be a copy mistake.

Remove vm_extra_install_base() from the openstack.conf entirely,
since it does not need to be overridden.

Enable password-less sudo for openstack images.

Update the VM_EXTRA_PACKAGES list for the openstack images.

Remove vm_extra_install_base() for the Azure image, now that the
waagent exists in the ports tree.

Add sysutils/azure-agent to the VM_EXTRA_PACKAGES list.

In vm_extra_pre_umount(), remove the explicit pkg(8) install
list, as dependencies are resolved by sysutils/azure-agent.

Add a 'list-cloudware' target to print the list of supported CLOUDWARE
values and a description.

Add the AZURE_DESC and OPENSTACK_DESC descriptions.

Update release(7)

Add 'list-vmtargets' target, which produces a list of all supported
VM and cloud provider images.

Add VHD_DESC, VMDK_DESC, QCOW2_DESC, RAW_DESC image descriptions.

Update release(7) to document the list-vmtargets target.

Add initial support for the GCE (Google Compute Engine) cloud hosting
provider image.

Remove the console setting from rc.conf(5), which is not used there.
While here, set console to include vidconsole in the loader.conf(5).

Remove the pkg-clean(8) call from vm_extra_pre_umount() since the
function is often overridden.

Add vm_extra_pkg_rmcache() to call pkg-clean(8) to avoid duplicated
code.

Move resolv.conf(5) removal back to vm_extra_pre_umount() where it
belongs.

The GCE image needs resolv.conf(5) to exist (created as part of the
image setup), so it cannot be removed.

Comment the line that configures ttys(5) to 'off', which makes it
impossible to test that the image boots.

Add a note explaining why the line is commented, and not (yet) removed
entirely.

Move the 'install' bits that are specific to virtual machine images
from the Makefile to Makefile.vm.

Rename the 'install' target to 'release-install', and add a new
'vm-install' target.

Add a new 'install' target that invokes the new targets.

Add WITH_CLOUDWARE to the list of make(1) variables for the release
build.

Remove hw.vga.textmode=1 from the VM image loader.conf, which was
included during test builds and not intended to be included when
merging this project branch back to head.

Remove mk-azure.sh, which is no longer needed.

r277536:
Rename the 'release' target to 'real-release', and add two targets,
'vm-release' and 'cloudware-release', that are invoked if
WITH_VMIMAGES and WITH_CLOUDWARE are not empty.

This fixes an issue where 'make release' would not build the cloud
provider targets because CLOUDWARE was not yet set.

Move the WITH_VMIMAGES and WITH_CLOUDWARE targets to Makefile.vm.

Note: There is no 'cloudware-install' target yet, since some of the
disk image names may need to be specific to the provider, so this is
probably best handled by the build scripts.

r277606:
Provide a recipe of "true" for building the "release" target once
its prerequisites are satisfied, in order to avoid having an implicit
rule triggered by the presence of release.sh.

r277609:
When iterating through VMFORMATS, the VMBASE file is not removed
or truncated to a zero-size file, which if used to create more
than one disk image format, can result in accidental pollution of
the target formatted disk image.

Instead of using a single VMBASE image (vm.img, by default), use
a single base file for each format, named as VMFORMAT.img, which
produces VMBASE.VMFORMAT as the final formatted image.

r277836:
Rename the 'system' target to 'disc1', which is specific to the
disc1.iso installer image.

Replace 'system' with 'release' in CLEANFILES, and add 'disc1'
to CLEANDIRS.

Ensure the 'dvd' target depends on 'packagesystem'.

Fix 'mini-memstick.img' prerequisite, which should be the 'bootonly'
target, not 'disc1' (previously 'system').

Use .TARGET as the target installation directory for the disc1.iso
and bootonly.iso images, which now expand to 'disc1' and 'bootonly'
respectively, mimicking the behavior of the 'dvd' target.

Remove '@true' from the 'release' target, and instead use
'touch ${.TARGET}' to prevent multiple iterations of
'make release' from clobbering previously-built installer
medium.

r277839:
Update release(7) to reflect renaming the 'system' target to 'disc1'.

r278118:
Move service_enable="YES" rc.conf(5) additions to VM_RC_LIST and
deduplicate.

Evaluate if firstboot_freebsd_update should be enabled based on
UNAME_r, because it is not supported for the -CURRENT or -STABLE
branches.

r278119:
Use ifconfig_DEFAULT="" instead of hard-coding vtnet(4)

r278206:
Bump copyright after r277458.

r278502:
In scripts/mk-vmimage.sh, prevent incorrect usage() by defaulting
VMCONFIG to /dev/null, and additionally ensuring VMCONFIG is not
a character device before it is sourced.

While here, be sure to exit if usage() is called.

This should effectively be no-op, but the usage() output was
discovered while investigating a larger issue.

* Several changes local to stable/10 were needed in order to handle
UEFI images that are specific to this branch.

Tested with: stable/10@r278906
Sponsored by: The FreeBSD Foundation

Bump .Dd per r276674

MFC r276483:

The variable used with install(1) for stripping should be STRIPBIN, not
STRIP_CMD

Reported by: lev

MFC r275908,r276309:

r275908:

Document STRIP_CMD in build(7) and note its importance with LOCAL_ITOOLS

Phabric: D1335
Reviewed by: brueffer
Sponsored by: EMC / Isilon Storage Division

r276309:

Bump .Dd for change done in r275908

MFC r273929:

r273929 (by jmmv):

MFV: Import atf-0.21.

MFC r271057: Create a /boot/dtb directory to house DTB blobs.

MFC r272414:
Merge the following revisions from ^/projects/release-vmimage:

r272234, r272236, r272262, r272264, r272269, r272271, r272272,
r272277, r272279, r272376, r272380, r272381, r272392, r272234,
r272412:

r272234:
Initial commit to include virtual machine images as part
of the FreeBSD release builds.

This adds a make(1) environment variable requirement,
WITH_VMIMAGES, which triggers the virtual machine image
targets when not defined to an empty value.

Relevant user-driven variables include:

o VMFORMATS: The virtual machine image formats to create.
Valid formats are provided by running 'mkimg --formats'

o VMSIZE: The size of the resulting virtual machine
image. Typical compression is roughly 140Mb, regardless
of the target size (10GB, 15GB, 20GB, 40GB sizes have been
tested with the same result).

o VMBASE: The prefix of the virtual machine disk images.
The VMBASE make(1) environment variable is suffixed with
each format in VMFORMATS for each individual disk image, as
well as '.img' for the source UFS filesystem passed to
mkimg(1).

This also includes a new script, mk-vmimage.sh, based on how
the VM images for 10.0-RELEASE, 9.3-RELEASE, and 10.1-RELEASE
were created (mk-vmimage.sh in ^/user/gjb/thermite/).

With the order in which the stages need to occur, as well as
sanity-checking error cases, it makes much more sense to
execute a shell script called from make(1), using env(1) to
set specific parameters for the target image than it does to
do this in make(1) directly.

r272236:
Use VMBASE in place of a hard-coded filename in the CLEANFILES
list.

r272262:
Remove a 'set -x' that snuck in during testing.

r272264:
release/Makefile:
Connect the virtual machine image build to the release
target if WITH_VMIMAGES is set to a non-empty value.

release/release.sh:
Add WITH_VMIMAGES to RELEASE_RMAKEFLAGS.

release/release.conf.sample:
Add commented entries for tuning the release build if the
WITH_VMIMAGES make(1) environment variable is set to
a non-empty value.

r272269:
release/Makefile:
Include .OBJDIR in DESTDIR in the vm-base target.

release/release.sh:
Provide the full path to mddev.

r272271:
Fix UFS label for the root filesystem.

r272272:
Remove comments left in accidentally while testing, so the
VM /etc/fstab is actually created.

r272277:
Remove the UFS label from the root filesystem since it is added
by mkimg(1) as a gpt label, consistent with the fstab(5) entry.

r272279:
Comment cleanup in panic() message when mkimg(1) does not support
the requested disk image format.

r272376:
Separate release/scripts/mk-vmimage.sh to machine-specific
scripts, making it possible to mimic the functionality for
non-x86 targets.

Move echo output if MAKEFLAGS is empty outside of usage().

Remove TARGET/TARGET_ARCH evaluation.

r272380:
Avoid using env(1) to set values passed to mk-vmimage.sh,
and instead pass the values as arguments to the script,
making it easier to run this by hand, without 'make release'.

Add usage_vm_base() and usage_vm_image() usage helpers.

r272381:
After evaluating WITH_VMIMAGES is non-empty, ensure
the mk-vmimage.sh script exists before running it.

r272392:
Add WITH_COMPRESSED_VMIMAGES variable, which when set enables
xz(1) compression of the virtual machine images.

This is intentionally separate to allow more fine-grained
tuning over which images are compressed, especially in cases
where compressing 20GB sparse images can take hours.

r272412:
Document the new 'vm-image' target, and associated release.conf
variables.

r272413:
Remove two stray comments added during the initial iterations
of testing, no longer needed.

Sponsored by: The FreeBSD Foundation

Revert r272724:
Features not yet available in stable/10 are needed in
mkimg(1), and it is more dangerous to tweak these changes
in stable/10 directly without explicitly testing certain
failure cases.

Re-addition of this change is imminent.

Sponsored by: The FreeBSD Foundation

MFC r272414:

Merge the following revisions from ^/projects/release-vmimage:

r272234, r272236, r272262, r272264, r272269, r272271, r272272,
r272277, r272279, r272376, r272380, r272381, r272392, r272234,
r272412:

r272234:
Initial commit to include virtual machine images as part
of the FreeBSD release builds.

This adds a make(1) environment variable requirement,
WITH_VMIMAGES, which triggers the virtual machine image
targets when not defined to an empty value.

Relevant user-driven variables include:

o VMFORMATS: The virtual machine image formats to create.
Valid formats are provided by running 'mkimg --formats'

o VMSIZE: The size of the resulting virtual machine
image. Typical compression is roughly 140Mb, regardless
of the target size (10GB, 15GB, 20GB, 40GB sizes have been
tested with the same result).

o VMBASE: The prefix of the virtual machine disk images.
The VMBASE make(1) environment variable is suffixed with
each format in VMFORMATS for each individual disk image, as
well as '.img' for the source UFS filesystem passed to
mkimg(1).

This also includes a new script, mk-vmimage.sh, based on how
the VM images for 10.0-RELEASE, 9.3-RELEASE, and 10.1-RELEASE
were created (mk-vmimage.sh in ^/user/gjb/thermite/).

With the order in which the stages need to occur, as well as
sanity-checking error cases, it makes much more sense to
execute a shell script called from make(1), using env(1) to
set specific parameters for the target image than it does to
do this in make(1) directly.

r272236:
Use VMBASE in place of a hard-coded filename in the CLEANFILES
list.

r272262:
Remove a 'set -x' that snuck in during testing.

r272264:
release/Makefile:
Connect the virtual machine image build to the release
target if WITH_VMIMAGES is set to a non-empty value.

release/release.sh:
Add WITH_VMIMAGES to RELEASE_RMAKEFLAGS.

release/release.conf.sample:
Add commented entries for tuning the release build if the
WITH_VMIMAGES make(1) environment variable is set to
a non-empty value.

r272269:
release/Makefile:
Include .OBJDIR in DESTDIR in the vm-base target.

release/release.sh:
Provide the full path to mddev.

r272271:
Fix UFS label for the root filesystem.

r272272:
Remove comments left in accidentally while testing, so the
VM /etc/fstab is actually created.

r272277:
Remove the UFS label from the root filesystem since it is added
by mkimg(1) as a gpt label, consistent with the fstab(5) entry.

r272279:
Comment cleanup in panic() message when mkimg(1) does not support
the requested disk image format.

r272376:
Separate release/scripts/mk-vmimage.sh to machine-specific
scripts, making it possible to mimic the functionality for
non-x86 targets.

Move echo output if MAKEFLAGS is empty outside of usage().

Remove TARGET/TARGET_ARCH evaluation.

r272380:
Avoid using env(1) to set values passed to mk-vmimage.sh,
and instead pass the values as arguments to the script,
making it easier to run this by hand, without 'make release'.

Add usage_vm_base() and usage_vm_image() usage helpers.

r272381:
After evaluating WITH_VMIMAGES is non-empty, ensure
the mk-vmimage.sh script exists before running it.

r272392:
Add WITH_COMPRESSED_VMIMAGES variable, which when set enables
xz(1) compression of the virtual machine images.

This is intentionally separate to allow more fine-grained
tuning over which images are compressed, especially in cases
where compressing 20GB sparse images can take hours.

r272412:
Document the new 'vm-image' target, and associated release.conf
variables.

r272413:
Remove two stray comments added during the initial iterations
of testing, no longer needed.

Sponsored by: The FreeBSD Foundation

MFC r270647: Add references to vt(4) and the configuration files in /usr/sha
MFC r270653: Update man-pages to correctly refer to changed pathes and namin
MFC r270657: More man pages that need to know about vt in addition to syscon
MFC r270659: (by pluknet@) Missed comma.
MFC r270660: Back-out the references to vt(4) from this man-page. It appears
MFC r270933: Add references to vt(4) to further man-pages.
MFC r270934: Final patches to the tools used to convert syscons keymaps for
MFC r270935: Add vt(4) support to the console initialisation script, specifi

Second batch of MFCs to add support for Unicode keymaps for use with vt(4).

It contains the following changes:

- Add references to vt(4) to relevant man-pages.
- Update comment in defaults/rc.conf to mention vt
- Update rc.d/syscons to warn about syscons keymaps used under vt.
An attempt is made to identify the vt keymap to load instead.
- Minor changes to the conversion tool based on mail comments on keymaps.

Relnotes: yes

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

Merge r267482,r267483,r267486,r267577,r267671,r267672 from head:

Remove send-pr and fix up all references to it. Replace it with a
stub send-pr directing people towards the web site.

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)

MFC r267160:
Dereference portaudit(1), as it is now deprecated and its
functionality exists in pkg-audit(8).

Sponsored by: The FreeBSD Foundation

MFC several WITH_TESTS-related documentation fixes.

- r258014 Document WITH_TESTS src.conf(5) option.
- r263089 Fix description of WITHOUT_BMAKE's purpose.
- r264408 Fix test suite name in src.conf(5).
- r264410 Document how to install the test suite.
- r264412 Add FreeBSD 10.1 to the list of recognized releases for Fx.
- r264413 Miscellaneous fixes to tests(7).

MFC r264343:
Add SRC_UPDATE_SKIP, DOC_UPDATE_SKIP, and PORTS_UPDATE_SKIP
variables. These are intended to allow bypassing the
'svn co /usr/{src,doc,ports}' step in the chroot when the
tree exists from external means.

The use case here is that /usr/src, /usr/doc, and /usr/ports
in the chroot exist as result of zfs dataset clones, so it
is possible (and happens quite often) that the included
distributions may not be consistent. (This is not the case
for -RELEASE builds, but does happen for snapshot builds.)

Sponsored by: The FreeBSD Foundation

MFC r264027, r264028, r264029, r264030, r264046, r264073:

r264027:
Add a new release build variable, WITH_COMPRESSED_IMAGES.

When set to a non-empty value, the installation medium is
compressed as part of the 'install' target in the release/
directory.

r264028:
Clean up trailing whitespace in release/Makefile.

r264029:
Fix logic error.

r264030:
If WITH_COMPRESSED_IMAGES is set, add the compressed images
to the CLEANFILES list.

r264046:
Use xz(1) instead of gzip(1) to compress release images
when WITH_COMPRESSED_IMAGES is used.

r264073:
Allow overriding xz(1) path.

Sponsored by: The FreeBSD Foundation

MFC r262810, r262862, r264105:
r262810:
Merge enabling building FreeBSD/arm images as part of the
release build process.

r262862:
Provide backwards-compatibility with release.conf SVNROOT
entries that do not have a trailing '/'.

r264105:
Add ZEDBOARD support for release builds.

* Local modifications:
- Set SRCBRANCH from head/ to stable/10/.
- Strip svn:merginfo from ^/projects/release-embedded to avoid
pollution.

Sponsored by: The FreeBSD Foundation

MFC r263428

share/man/man7/tests.7
Added a section on test suite configuration, and cleaned up up grammar
errors and awkward prose. The config variables were discussed on
freebsd-testing.

MFC r263812:

Update build(7) with LOCAL_* vars

MFC r262499, r262505, r262507, r262509:

r262499:
release.sh:
- Add a VCSCMD variable that defaults to 'svn checkout',
and update places 'svn co' is used directly.
- After sourcing a configuration file, prefix SRCBRANCH,
PORTBRANCH, and DOCBRANCH with the SVNROOT.
- Properly capitalize 'FreeBSD.org' in the default SVNROOT.
- Update Copyright.

release.conf.sample:
- Add an example to use git instead of svn, by nullifying
SVNROOT, and setting SRCBRANCH, DOCBRANCH, and PORTBRANCH
to the URL fo a git repository.

release.7:
- Document VCSCMD.

r262505:
In release/Makefile, remove exclusion of CVS directories in the
src/ and ports/ distributions.

While I am thinking about it, exclude .git directories for src/
and ports/, as somewhat of a followup to r262499.

r262507:
Chase r262505, and remove CVS exclusion from picobsd builds.

r262509:
Rework how WORLD_FLAGS and KERNEL_FLAGS are set, to remove an
unnecessary expr(1) call.

Sponsored by: The FreeBSD Foundation

MFC r262451:

hier(7): Add /usr/lib/private

MFC: r262243

Fix a cross-reference.

MFC r259879: Clean up manual pages after BIND removal.

Set up the /usr/tests hierarchy.

This is a MFC of the following into stable/10:
- r257097 Set up the /usr/tests hierarchy.
- r257098 Add missing WITHOUTTESTS file.
- r257100 Add a tests(7) manual page.
- r257105 Disable WITHTESTS= for now.
- r257848 Fix buildworld when WITHTESTS is enabled.
- r257850 Subsume the functionality of MKATF into MKTESTS.
- r257851 Handle the removal of the test suite when WITHOUTTESTS=yes.
- r257852 Install category Kyuafiles from their category directories.
- r258232 Install BSD.tests.mtree when MKTESTS is yes.

Note that building with WITH_TESTS is still broken at this point (and
hence why WITHOUT_TESTS is the set as the default). Subsequent pullups
will fix the remaining issues.

MFC r257805, r257806, r257807, r257942:

r257805:
Add a 'mini-memstick.img' release target, which will use the
'bootonly.iso' components to create a smaller memory stick image.

This is useful for system recovery, where a full memstick.img image
is not necessarily needed (or wanted). In addition, it is possible
to do bootonly-style installation, where the base.txz, kernel.txz,
etc. are fetched from a remote source.

Provide backwards-compatible target (mini-memstick), to keep in sync
with the targets documented in release/Makefile.

r257806:
Remove extra target from 'memstick' that I forgot to remove before
previous commit.

r257807:
Update release(7) to include 'mini-memstick'.

r257942:
Fix a few style nits.

Sponsored by: The FreeBSD Foundation

Hoist all the mergeinfo up to the root in preparation for enforcing merges
to the root only. All MFC's were rerecorded to the root.

Going forward, if an MFC includes mergeinfo, it will need to be made to
the root and committed from the root. Merges with --ignore-ancestry
or diff | patch can go anywhere.

The mergeinfo in HEAD is in a bad state from years of neglect and manual
tampering and this was branched into 10.x. This confuses the coalescing
code and prevents it from doing its job.

Approved by: re (gjb, implicit)

MFC r258786, r258796, r258797, r258847, r258853, r258949:

r258786:
Move OPTIONS_UNSET outside of the PBUILD_FLAGS variable, otherwise
the textproc/docproj port build fails.

r258796 (hrs):
- Prevent TARGET and TARGET_ARCH from being defined as empty when
TARGET="" and/or TARGET_ARCH="" is specified.
- Remove extra ().

r258797 (hrs):
Use standard CLEANFILES/CLEANDIRS and clean target in bsd.obj.mk.

r258847:
Provide reproducibility between builds by building pkg(8) from ports,
instead of using pkg-bootstrap.

This should resolve a problem that was discovered during 10.0-BETA4
freebsd-update(8) builds,

r258853:
Turn off the dvdrom target by default. dvd1.iso is now built by
specifying 'WITH_DVD=1' during 'make release'.

This caused some problems during the freebsd-update builds for
10.0-BETA4.

r258949:
Ensure WITH_DVD is not empty to prevent 'WITH_DVD= ' from evaluating
to true.

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

MFC r258305, r258307, r258308, r258309, r258310, r258314, r258317,
r258319, r258320:

r258305:
Use the IMAGES variable to determine which image files to remove
as part of 'make -C /usr/src/release clean'.

r258307:
Add a script and configuration files to fetch pre-built packages
from pkg.FreeBSD.org for inclusion on release medium (dvd1.iso).

r258308:
Unconditionally copy the build host /etc/resolv.conf into
the chroot directory, since hostname resolution may be
needed in the case of building a dvd image (with packages)
and also setting 'NOPORTS=1'.

r258309:
Set the PKG_CACHEDIR directory to 'dvd/' instead of 'release/'
in preparation of adding a 'dvd1.iso' target.

r258310:
Add the 'dvd1.iso' target. This mimics the 'release.iso' target,
with the additional step of fetching packages for inclusion on the
dvd image.

The 'pkg-stage' target is used to run 'scripts/pkg-stage.sh' if
the '${TARGET}/pkg-stage.conf' configuration file exists (currently
only amd64 and i386).

Allow dvd1.iso to be skipped if NODVD=1.

r258314:
Fix how ABI is evaluated so it matches more than a dot-zero
case.

r258317:
Document the 'dvdrom' target.

r258319:
Remove WITHOUT_PROFILE=1 for the dvd1.iso medium.

r258320:
Simplify PKG_ABI for pkg-stage.sh.

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

MFC r257344,r257403:

Move /etc/keys to /usr/share/keys where users are less likely to modify them.

Approved by: bapt
Approved by: re (gjb)

MFC r257151:

Document /var/cache/pkg into hier(7) which pkg(8) uses.

Approved by: bapt
Approved by: re (glebius)

MFC: r256770,r257142,r257145,r257146,r257147,r257148,
r257149,r257150,r257158,r257159,r257164,r257168,
r257193

- Support checking signature for pkg bootstrap from remote
and for 'pkg add ./pkg.txz'

- Be verbose on where pkg is being bootstrapped from.

- Add support for reading configuration files from /etc/pkg.
For now only /etc/pkg/FreeBSD.conf is supported.

- Add test package signing key fingerprint into /etc/keys/pkg/trusted.

- Disable fingerprint checking by default for now as the official
packages are not yet signed.

Approved by: bapt
Approved by: re (glebius)

MFC 256365
Remove most of the ATF tools and the _atf user.

Approved by: re

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

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

Remove the {SRC,DOC,PORT}REVISION variables from release(7), and
update the default {SRC,DOC,PORT}BRANCH defaults.

Submitted by: nwhitehorn
X-MFC-With: r254224, r254294
X-MFC-To: stable/9, releng/9.2

- Remove the defaults for TARGET/TARGET_ARCH.

- Note that WORLD_FLAGS and KERNEL_FLAGS set the number of
make(1) jobs only on SMP-capable systems.

MFC after: 3 days
X-MFC-With: r254224
X-MFC-To: stable/9, releng/9.2

- Update the wrapper script to 'release.sh', as used by the FreeBSD
Release Engineering Team as of 9.2-RELEASE.

- Document that a cross-build release is possible by setting the
TARGET and TARGET_ARCH variables.

- Include an example of using release.sh with and without the
optional configuration file.

- Document the supported release.sh configuration file variables.

- Update the 'cdrom' target output file to disc1.iso.

- Update the 'memstick' target output file to memstick.img.

- Add attributions for the last major updates to this manual page.

- Fix some mdoc(7) style nits:
- Sentences should begin on a new line
- Use .Pq to enclose full lines in parenthesis

Ports switched from dialog to dialog4ports some time ago.

PR: docs/179785
Repored by: Kevin Oberman <rkoberman@gmail.com>
Submitted by: "Ilya A. Arkhipov" <rum1cro@yandex.ru>
MFC After: 3 days

mdoc sweep

Fix several typos

PR: kern/176054
Submitted by: Christoph Mallon <christoph.mallon@gmx.de>
MFC after: 3 days

Remove obsolete references to sysinstall.

This change is not intended for MFC.

PR: docs/177570
Submitted by: Garrett Cooper <yaneurabeya@gmail.com> (partial)
Approved by: bcr (mentor)

Suggest using the https: protocol not the svn: protocol to retrieve the
various repositories.

Modernize some portions of the ports man page.
Stop documenting other operating systems's default patha

Approved by: bcr (mentor)

- Add CHECKSUM.* support in Makefile[1].
- Use ln -fs to create a symlink.
- Remove pkgadd for docports.
- Use WITHOUT_JADETEX=yes instead of WITH_JADETEX=no.
- Add {WORLD,KERNEL}_FLAGS to [BTWK]MAKE.
- Use makefs(8) and gpart(8) for sparc64 ISO image[2].
- Add publisher option to makefs(8)[2].

Based on work by: gjb[1]
Discussed with: marius, nwhitehorn[2]

Update svn port directory in release(7).

Submitted by: Nikolai Lifanov

Remove outdated reference to tcp inflight limiting. It was removed
a long time ago.

MFC after: 1 week

Modernize parts of the ports.7 manual page.

Approved by: bcr (mentor)
MFC after: 3 days

Move detailed description of BLOCKSIZE to getbsize(3).

MFC after: 2 weeks.

Remove quite a bit of stale data from the tuning.7
While here fix some style issues.

Submitted by: many (via the SystemTuning wiki page)
Approved by: bcr (mentor)
MFC after: 3 days

Revert previous commit.

Catch up with r242520. s/maxusers/maxbikesheds

Add ATF to the build. This is may be a bit rought around the egdes,
but committing it helps to get everyone on the same page and makes
sure we make progress.

Tinderbox breakages that are the result of this commit are entirely
the committer's fault -- in other words: buildworld testing on amd64
only.

Credits follow:

Submitted by: Garrett Cooper <yanegomi@gmail.com>
Sponsored by: Isilon Systems
Based on work by: keramida@
Thanks to: gnn@, mdf@, mlaier@, sjg@
Special thanks to: keramida@

Apply local patches to mandoc and connect it to the build.

- adds a couple more library strings used in the tree
- changes some more to the current groff spelling
- changes page footer to match groff style

Disconnect non-MPSAFE NTFS from the build in preparation for dropping
GIANT from VFS. This code is particulary broken and fragile and other
in-kernel implementations around, found in other operating systems,
don't really seem clean and solid enough to be imported at all.
If someone wants to reconsider in-kernel NTFS implementation for
inclusion again, a fair effort for completely fixing and cleaning it
up is expected.

In the while NTFS regular users can use FUSE interface and ntfs-3g
port to work with their NTFS partitions.

This is not targeted for MFC.

Disconnect non-MPSAFE NWFS from the build in preparation for dropping
GIANT from VFS. In addition, disconnect also netncp, which is a base
requirement for NWFS.

In the possibility of a future maintenance of the code and later
readd to the FreeBSD base, maybe we should think about a better location
for netncp. I'm not entirely sure the / top location is actually right,
however I will let network people to comment on that more specifically.

This is not targeted for MFC.

Disconnect non-MPSAFE PORTALFS from the build in preparation for dropping
GIANT from VFS.

This is not targeted for MFC.

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

Reviewed by: fjoe

Remove some duplicated advice.
While here increase the suggested sizes for the
partition as "make universe" takes a lot more
space than mentioned.

Reviewed by: gavin
Approved by: gjb
MFC after: 3 days
X-MFC-With: r240728

mdoc: remove superfluous paragraph macro.

Rewrite portions of development.7 to make sense
in the world of subversion.

Approved by: gjb
MFC after: 2 weeks

Update release(7) to reflect changes from r240586 and r240587:

- Remove cvs(1) references.
- Remove CVS* environment references.
- Add default entries for the default SVNROOT for the Ports
Collection, and Documentation Project.
- While here, update 'SGML-based documentation' to 'XML-based',
since the recent SGML->XML conversion.
- Update an example providing SVNROOT environment usage.

Reminded by: nwhitehorn
MFC After: 1 week
X-MFC-With: r240586, r240587

Bump date missed in r202756

PR: docs/171624
Submitted by: bdrewery
Approved by: gabor
MFC after: 3 days

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

Fix style nit: don't use leading zero for dates in .Dd

Prompted by: brueffer
Approved by: brueffer
MFC after: 3 days

Fix an mdoc(7) formatting nit.

MFC after: 3 days

Typo and mdoc(7) style fixes.

PR: 167890
Submitted by: Nobuyuki Koganemaru (kogane&jp!freebsd!org)
MFC after: 3 days

Remove duplicate words in mdoc(7) pages.

PR: 167810
Submitted by: Bryan Drewery {bryan!shatow%net} (hackers lounge)
Found with: textproc/igor
MFC after: 3 days

Stop lying about default UFS blocksizes.

This catches up with the year-old change to default blocksizes. Also
reduce the variants of spelling gigabyte from 3 down to 2 (GB and GiB).

Suggested by: arundel (about a year ago now ...)

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

PR: docs/167459
Submitted by: "Bryan Drewery" <bryan@shatow.net>
Approved by: bcr
MFC after: 1 week

Remove trailing whitespace per mdoc lint warning

Disussed with: gavin
No objection from: doc
Approved by: joel
MFC after: 3 days

mdoc: terminate quoted strings.

Reviewed by: brueffer

Remove superfluous paragraph macro.

Fix date from r231111.

Pointy-hat to: gjb (myself, approver of r231111)

Fix some Xr references:

- ada(4): ad(4) - removed, ada(4) would be a self-referencing entry
- cd(4): ad(4) -> ada(4)
- da(4): ad(4) -> ada(4)
- DEVICE_PROBE(9): ugen(5) -> ugen(4)
- ed(4): dhclinet(8) -> dhclient(8) (typo)
- lmc(4): Netgraph(4) -> netgraph(4)
- security(7): rc.conf(8) -> rc.conf(5)
- sfxge(4): cpuset(8) -> cpuset(1)
- sbp(4): sysctl(1) -> sysctl(8)
- portindex(5): build(1) -> build(7)
- u3g(4): usbconfig(5) -> usbconfig(8)
- usb_quirk(4): usbconfig(5) -> usbconfig(8)

Found with: textproc/igor
MFC after: 3 days

ports(7) currently makes no mention of LOCALBASE: fix that

PR: docs/159551
Submitted by: Matthew Seaman <m.seaman@infracaninophile.co.uk>
Approved by: gjb
MFC after: 3 days

Add /usr/src/cddl/ to the hierarchy.

No need to run buildworld before generate-release.sh.

After several suggestions from people, move eventtimers page from 7 to 4.

Further automate production release generation by naming files the right
things and generating checksums.

MFC after: 1 week

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

Pointy-hat to: gjb (myself)

Disallow various debug.kdb sysctl's when securelevel is raised.

PR: 161350

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.

It is generally considered useful for release media to have kernels on them.

Submitted by: joel

Bump document date.
I accidently committed the actual change (typo fix) in r222492, which
is a completely unrelated change.

Add a short description about NO_CHECKSUM.

PR: docs/155980
Submitted by KOIE Hidetaka (koie at suri co jp)
MFC after: 7 days

[mdoc] Fixed .Dt call.

Add a description to the checksum target about not only
being able to verify, but also having the ability to
fetch distfiles that are missing or failed the checksum
calculation

PR: docs/138887
Submitted by: Radim Kolar (hsn at sendmail dot cz)
MFC after: 5 days

Update some terminology: floppies are no longer built, and FreeBSD is not
necessarily distributed by CVS any longer.

Don't do make release and make install in one step. Setting DESTDIR for
make release has deleterious consequences.

Add an install target to release/Makefile instead of grubbing around
(and requesting that users grub around) in /usr/obj. Also make sure that
make clean removes the bootonly media and clean up that target a little.

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

Remove duplicate "in".

Suggested by: Rob Farmer <rfarmer at predatorlabs.net>
MFC after: 3 days

Revert some of r177626. "in in" is valid in certain sentences.

PR: 121490
MFC after: 3 days

Move the sticky manual from section 8 to section
7 like NetBSD has, since this is not a command
on itself.

PR: 124468
MFC after: 1 week

Document TRYBROKEN in ports(7).

PR: docs/153542
Submitted by: Eitan Adler <lists@eitanadler.com>
MFC after: 3 days

- 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

Document vfs.ncsizefactor and vfs.ncnegfactor.

MFC after: 2 weeks

mdoc: drop redundant .Pp and .LP calls

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

Add atrtc(4) manual page.

Add attimer(4) manual page.

Add eventtimers(7) man page, briefly describing event timers subsystem
functionality and configuration options.

o Sync the man page with the reality: nfs/ includes
are under include/ and include/fs/.

PR: docs/139153
Submitted by: gjb
MFC after: 1 week

Fix typos, spelling, formatting and mdoc mistakes found by Nobuyuki while
translating these manual pages. Minor corrections by me.

Submitted by: Nobuyuki Koganemaru <n-kogane@syd.odn.ne.jp>

Describe vfs.read_max and update vfs.hirunningspace documentation. While
there, update nits.

Considered viewed by: jeff, phk, rwatson

- Fix typo, it should have been c78.7

Submitted by: pluknet <pluknet@gmail.com>

- Add c99(7) manual page
- Add MLINKS to c.7, c79.7, c89.7, c90.7

mdoc: order prologue macros consistently by Dd/Dt/Os

Although groff_mdoc(7) gives another impression, this is the ordering
most widely used and also required by mdocml/mandoc.

Reviewed by: ru
Approved by: philip, ed (mentors)

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

Correct a minor mistake in my previous commit.

getutxent is in category 3, not 5.

Remove stale references to utmp(5) and its corresponding filenames.

I removed utmp and its manpage, but not other manpages referring to it.

Use the newly brought %U macro.

- s/unsecure/insecure/ as this is the correct keyword

Add a missing word.

PR: 140989
Submitted by: Lachlan Kang
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.

Use our canonical .Dd format.

Submitted by: Ulrich Spoerlein

Fixed markup bugs.

Document MAKE_DVD and xref svn in ports.

Approved by: re@ (kib)

Document the newly added SVNCMDARGS, SVNROOT, and SVNBRANCH variables.

Approved by: re (kib)

Usermode portion of the support for swap allocation accounting:
- update for getrlimit(2) manpage;
- support for setting RLIMIT_SWAP in login class;
- addition to the limits(1) and sh and csh limit-setting builtins;
- tuning(7) documentation on the sysctls controlling overcommit.

In collaboration with: pho
Reviewed by: alc
Approved by: re (kensmith)

Add C++ operators to operator(7) manual page.

Submitted by: Christoph Mallon <christoph.mallon@gmx.de>

A system with plenty of memory would not require so much swap for generic
usage.

Discussed with: dillon

Build fixups for the new USB stack.

- Rename adding_user(8) to adding_user(7). There's no adding_user utility,
but the man page describes conceptual information about the process of
adding a user, thus it should belong to section 7.
- Remove HISTORY and BUGS sections because of the aforementioned reason.

PR: docs/130151
Submitted by: Marian Cerny <jojo@matfyz.cz>
MFC after: 3 days

s/use/using/ in previous commit.

Suggested by: jhb

Better description of kern.ipc.maxpipekva.

Discussed with: kib

Add a comment on kern.ipc.maxpipekva.

PR: 105997
Reviewed by: keramida

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 targets run-depends-list and build-depends-list

PR: docs/127575
Submitted by: Walter Venable <walt relnor.com>
Approved by: keramida
MFC after: 3 days

Document the NO_XXX options supported by our Makefile.inc1.

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

Correct a typo.

src/sys/dev/usb2/controller/uss820dci_pccard.c
src/sys/dev/usb2/core/usbdevs
src/sys/dev/usb2/include/urio2_ioctl.h
src/sys/dev/usb2/storage/ustorage2_fs.h

These files are not used any more.

src/usr.sbin/Makefile
src/etc/mtree/BSD.include.dist
src/include/Makefile
src/lib/Makefile
src/share/man/man7/hier.7
src/share/mk/bsd.libnames.mk
src/etc/mtree/BSD.include.dist

Make "usbconfig" and "libusb20" a part of the default build.

src/sys/dev/usb/rio500_usb.h
src/sys/dev/usb2/storage/urio2.c

Use common include file.

src/sys/dev/usb2/bluetooth/ng_ubt2.c

Make USB bluetooth depend on "ng_hci" module.

src/sys/dev/usb2/controller/ehci2.c
src/sys/dev/usb2/controller/ehci2.h

Patches for Marvell EHCI.

src/sys/dev/usb2/core/usb2_busdma.c

Bugfix for 64-bit platforms. Need to unload the previously loaded DMA
map and some cleanup regarding some corner cases.

src/sys/dev/usb2/core/usb2_core.h
src/sys/dev/usb2/core/usb2_dev.c
src/sys/dev/usb2/core/usb2_dev.h

Bugfix for libusb filesystem interface.

New feature: Add support for filtering device data at the expense of the
userland process.

Add some more comments.

Some minor code styling.

Remove unused function, usb2_fifo_get_data_next().

Fix an issue about "fifo_index" being used instead of "ep_index".

src/sys/dev/usb2/core/usb2_device.c
src/sys/dev/usb2/core/usb2_generic.c

Bugfix for Linux USB compat layer. Do not free non-generic FIFOs when
doing an alternate setting.

Cleanup USB IOCTL and USB reference handling.
Fix a corner case where USB-FS was left initialised after
setting a new configuration or alternate setting.

src/sys/dev/usb2/core/usb2_hub.c

Improvement: Check all USB HUB ports by default at least one time.

src/sys/dev/usb2/core/usb2_request.c

Bugfix: Make sure destination ASCII string is properly zero terminated
in all cases.

Improvement: Skip invalid characters instead of replacing with a dot.

src/sys/dev/usb2/core/usb2_util.c
src/sys/dev/usb2/image/uscanner2.c

Spelling.

src/sys/dev/usb2/include/Makefile

Share "usbdevs" with the old USB stack.

src/sys/dev/usb2/include/usb2_devid.h
src/sys/dev/usb2/include/usb2_devtable.h

Regenerate files.

Alfred: Please fix the RCS tag at the top.

src/sys/dev/usb2/include/usb2_ioctl.h

Fix compilation of "kdump".

src/sys/dev/usb2/serial/ubsa2.c
src/sys/dev/usb2/serial/ugensa2.c

Remove device ID's which will end up in a new 3G driver.

src/sys/dev/usb2/sound/uaudio2.c

Correct a debug printout.

src/sys/dev/usb2/storage/umass2.c

Sync with old USB stack.

src/lib/libusb20/libusb20.3

Add more documentation.

src/lib/libusb20/libusb20.c

Various bugfixes and improvements.

src/usr.sbin/usbconfig/dump.c
src/usr.sbin/usbconfig/usbconfig.c

New commands for dumping strings and doing custom USB requests from
the command line.

Remove keyword requirements from generated files:
"head/sys/dev/usb2/include/usb2_devid.h"
"head/sys/dev/usb2/include/usb2_devtable.h"

Remove ISDN4BSD (I4B) from HEAD as it is not MPSAFE and
parts relied on the now removed NET_NEEDS_GIANT.
Most of I4B has been disconnected from the build
since July 2007 in HEAD/RELENG_7.

This is what was removed:
- configuration in /etc/isdn
- examples
- man pages
- kernel configuration
- sys/i4b (drivers, layers, include files)
- user space tools
- i4b support from ppp
- further documentation

Discussed with: rwatson, re

Remove netatm from HEAD as it is not MPSAFE and relies on the now removed
NET_NEEDS_GIANT. netatm has been disconnected from the build for ten
months in HEAD/RELENG_7. Specifics:

- netatm include files
- netatm command line management tools
- libatm
- ATM parts in rescue and sysinstall
- sample configuration files and documents
- kernel support as a module or in NOTES
- netgraph wrapper nodes for netatm
- ctags data for netatm.
- netatm-specific device drivers.

MFC after: 3 weeks
Reviewed by: bz
Discussed with: bms, bz, harti

Fix some "in in" typos in comments.

PR: 121490
Submitted by: Anatoly Borodin <anatoly.borodin@gmail.com>
Approved by: rwatson (mentor), jkoshy
MFC after: 3 days

The config-recursive target is not run during the normal install process, move
it down to where it belongs.

Document 'all-depends-list' target and bump doc date.

PR: 119519
Submitted by: Yuri Pankov <yuri.pankov@gmail.com>
Reviewed by: flz

Document the 'maintainer' target.

PR: 119699
Submitted by: Warren Block <wblock@wonkity.com>
MFC after: 3 days

Correct the sysconf variable name, _SC_CLK_TCK.

Add an additional make variable EXTRAMIBSYMS which allows to specify
definition files that are used only for extracting symbols. This is useful
for inter-module dependencies and files containing only enum-definitions.

MFC after: 4 weeks

- Remove incomplete sentence fragment

PR: docs/117451
Submitted by: Warren Block <wblock@wonkity.com>
MFC after: 3 days

- Document PORT_DBDIR

PR: docs/114731
Submitted by: Matthew Seaman <m.seaman@infracaninophile.co.uk>

- Document icase variable of make search, which can be used to control
case-sensitivity

PR: docs/117593
Submitted by: Nikolay Bachiyski <nbachiyski@developer.bg>

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)

Clean up after last commit.

Remove traces of vinum and replace with gvinum.
Mention gstripe and gjournal.

Style (whitespace-only) change.

- Fix origin of the portcheckout port as we have it in the port-mgmt
category now

PR: docs/115193
Submitted by: Tomas Mozes <hydrapolic at gmail dot com>
Approved by: re (bmah),
keramida (mentor)
MFC after: 0 days

Stop mentioning /usr/X11R6.

Approved by: re (hrs)

- Update portaudit location

Submitted by: Dominique Goncalves <dominique.goncalves@gmail.com>
MFC after: 3 days
Approved by: re (hrs)

Commit IPv6 support for FAST_IPSEC to the tree.
This commit includes all remaining changes for the time being including
user space updates.

Submitted by: bz
Approved by: re

- Remove UMAP filesystem. It was disconnected from build three years ago,
and it is seriously broken.

Discussed on: freebsd-arch@
Approved by: re (mux)

Remove /usr/X11R6 and subdirs.

MFC after: 3 days

I understood the MLINK part incorrectly, it should be the other way around
also remove the init mlink to securelevel.

Discussed with and sharing pointyhat with: brueffer

Revert my previous change, add an MLINK from securelevel.7 to security.7

Discussed with: brueffer

Quick kill posix4 directory.

Submitted by: rodrigc (BSD.include.dist).

- Remove the leading zero from the day of month.

Noticed by: ru@
Approved by: delphij@ (mentor)
MFC after: 1 week

- Remove the deprecated ``/stand'' hierarchy.

PR: docs/111137
Submitted by: Niclas Zeising
Approved by: delphij@ (mentor)

- Add missing subdirectories in BSD.usr.dist mtree file.
- Update hier(7) to reflect latest changes in mtree file.
- Add UPDATING entry following Intel firmwares inclusion.

Submitted by: mlaier
MFC after: 1 month

Document the loader tunables which control hard process memory limits.

Reviewed by: ru

Spelling fixes.

Don't use abbreviations for some descriptions / minor spelling fixes.

Remove reference to a man page of pib, an obscure third-party tool, whose port
does not install any manpages.

MFC after: 3 days

o Xr sendfile(2).

Remove reference to mount_procfs.

Reminded by: ru

Enforce RELEASENOUPDATE if EXTSRCDIR is used.

Suggested by: jb

Reduce our pointy-hat pool capacity by one (i.e. bump manpage date,
after the last change to this manpage).

Reminded by: ru

Document NO_IGNORE and its interation with FORBIDDEN.

Triggered by: a question by Panagiotis Hadgis <hadgis@ceid.upatras.gr>

Markup glitch.

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

o Document 'make quicksearch'.

PR: docs/103162
Submitted by: Lars Engels
MFC after: 1 week

Remove references to the pam(8) manual page. It does not exist.

Requested by: novel
Discussed with: brueffer, simon

So there is where that handbook paragraph came from. Kill it here too.
Remove a paragraph about over building security, it's a bit off.

Discussed with: des, FreeBSD-security

The BUILDNAME variable need not be specified.

Add the DTrace library script directory.

Add /usr/lib/engines for OpenSSL engines.

When securelevel is >= 1, /dev/io may not be opened at all (not just for
write). Update the securelevel description to match this.

Reported by: Alexandros Kosiaris <akosiaris@gmail.com>
MFC after: 3 days

- Document RANDOMIZE_MASTER_SITES, MASTER_SORT
- Remove OPTIONS, it's no user settable variable

- Document new missing target

Cross-reference src.conf(5).

o Replace alpha-specific DESTDIR to a sparc64 one.

Spotted by: Gennady Proskurin

Send the pcvt(4) driver off to retirement.

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

apropos(1) does not expand *roff macros that should appear in .Nd
text and, as a result, 'FreeBSD' is not visible in apropos output
when security(7) is displayed. Fix this buglet by using a
literal 'FreeBSD' string in .Nd

PR: docs/85986
Submitted by: Matthias Schmidt <schmidtm@mathematik.uni-marburg.de>
MFC after: 1 week

Add a /media to FreeBSD. /media is a directory designed to contain
subdirectories that will be used for removable media mount points (i.e.
mount points for CDs, floppy disks, USB drives, etc.). While the primary
purpose of /media is to provide a location for HAL
(http://www.freedesktop.org/wiki/Software_2fhal) to mount volumes, it could
be used by any application that needs to manage removable media volumes.

Discussed on: arch@
Approved by: mux
MFC after: 1 week

Document the bluetooth/, rc.d/, security/ and ssh/ etc subdirectories.

Prodded by: markus
MFC after: 3 days

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

Security levels are not discussed further in init.8; we moved that
discussion to this manual.

Add EXTDOCDIR and EXTPORTSDIR.

MFC after: 1 week

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

Reviewed by: ru (multiple passes)

Provide a short description.

-mdoc sweep.

s/Three file/Three files/

Submitted by: ru

Remove hard sentence breaks. Correct the width calculation for the list
indent.

Submitted by: ru

This is a short man page which describes bsd.snmpmod.mk. It documents
only the features that this file layers on top of bsd.lib.mk and should
therefore cross-reference to bsd.lib.mk, which doesn't exist.

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

Remove all references to nonexistent FreeBSD Security Architecture
document.

Moved descriptions of securelevels from init(7) to security(7).

Files used both "securelevel" and either "secure level" or
"security level"; all are now "security level".

PR: docs/84266
Submitted by: garys
Approved by: keramida
MFC after: 3 days

Add a small paragraph that describes how the current environment
settings can be displayed, near the end of the DESCRIPTION section,
immediately after the paragraph that describes how they can be set.

Add a reference to printenv(1) too (and the ``printenv'' csh builtin).

Submitted by: Gary W. Swearingen <garys@opusnet.com>
PR: docs/85008

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>

- 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)

s/Lefler/Leffler/

Approved by: brueffer
MFC after: 3 days

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)

Document config-recursive target.

PR: docs/82586
Submitted by: Imobach González Sosa <imobachgs@banot.net>
Approved by: trhodes (mentor)
MFC after: 1 week

s/then/than

- Remove MLINKS to nonexistant manpages
- Change some section numbers to match reality
- For MLINKS to manpages from ports, mention which port installs them

MFC after: 3 days

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

Approved by: re (hrs)

Assorted markup fixes and minor wordsmithing.

Approved by: re

Correct script path.

PR: docs/80948
Submitted by: anonymous coward
Approved by: trhodes (mentor)
MFC after: 2 days

Document SEPARATE_LIVEFS (forgot this in previous commit).

- Document the top-level package-split target.
- Update the description of the cdrom.1 target and add notes for cdrom.2
and cdrom.3.
- Document CD_PACKAGES_TREE (CD_EXTRA_BITS wasn't documented before).
- Document CVSARGS.
- Remove DISC[12]_{LABEL,NAME}.
- Remove NOPORTREADMES.
- Remove references to drivers.conf files and man page.
- Update version number for a CURRENT snapshot to 6.0.

Fix a few markup nits in previous commit.

Noticed by: ru, who else? :)

Note the ACPI clock and its characteristics.

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

Expand contractions.

Expand *n't contractions.

Introduce three new targets for ports collection:
showconfig-recursive, rmconfig-recursive and config-conditional.

MFC after: 3 days

Fixed xrefs.

Fixed xref.

Sort sections.

Overhaul the markup.

Fix the pbio include file installation process and the
corresponding documentation.

Noticed by: ru
Reviewed by: ru

Scheduled mdoc(7) sweep.

mdoc style nit: "\-" should only be used to represent a minus sign.

Suggested by: ru

/usr/lib doesn't contain only archive (ar(1) style) libraries. Shared
libraries live there too. Also point to ar(1) which contains a nice
description of what an 'archive library' is.

PR: docs/76056
Submitted by: Enrique Matías Sanchez <cronopios@gmail.com>
MFC after: 3 days

IDE_DELAY was only available as an option for the wd driver of PC98.
Now that the driver is gone, `tuning' IDE_DELAY makes no sense.

Submitted by: Joel Dahl joel at automatvapen dot se

Remove mention of block devices. Mention that entries under /dev
are managed by devfs(5). Add cross-references.

Reviewed by: ru

Introduce new variables FETCHINDEX, MASTER_SITE_INDEX and add
description for MASTER_SITE_BACKUP.

Based on PR: ports/74709
Submitted by: Valentin Nechayev <netch@netch.kiev.ua>
Reviewed by: ru
MFC after: 3 days

Typo fix: s/ROOR/ROOT/;

PR: docs/75139
Submitted by: Richard Smith

Update the description of SCSI_DELAY and annotate IDE_DELAY as a
PC98-only option.

Submitted by: Joel Dahl (joel at automatvapen dot se)
PR: docs/74862
MFC after: 3 days

MNT_NODEV is deprecated.

- Fix typo in portaudit reference.
- Bump document date for last commit.

Pointed out by: ceri, ru
Pointy hat to: simon

- Document the DISABLE_VULNERABILITIES knob.
- Don't say this manual page is too long, it's not that long.
- s/man page/manual page/g

MFC after: 3 days

Remove some references to I386_CPU and 80386 CPUs.

Sync description of IP portrange sysctls with reality.

MFC after: 2 weeks

Mention pf.conf(5), pfctl(8) and pflogd(8) as ADDITIONAL READINGs.

Requested by: Chris Laverdure <dashevil sympatico ca>

There can be up to three bootable ISO images (bootonly, miniinst,
and disc1). The exact number depends on a couple of parameters,
so don't give a specific number here.

Pointed by: wilko

Instead of "OpenFirmware", "openfirmware", etc. use the official spelling
"Open Firmware" from IEEE 1275 and OpenFirmware.org (no pun intended).

Ok'ed by: tmm

Bring back 'NO_FLOPPIES', but as a user external knob.
The internal logic knob remains MAKE_FLOPPIES.

Suggested by: ru

Accept the fact that floppies either aren't applicable or relevant on most
platforms. So follow 'MAKE_ISOS''s style and s/NO_FLOPPIES/MAKE_FLOPPIES/g.

Update the date.

Reminded by: ru

Inform hier(7) about /usr/include/geom/raid3/ directory.

Inform hier(7) about /usr/include/geom/mirror/ directory.

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

Describe better what the initial /usr/obj is expected to be populated with.

Prodded by: grehan

Remove another mention of "make world".

Fix a documentation bug: "make release" uses "make buildworld"
not "make world", as the first step of building the release.
While here, remove another mention of "make world", as the
latter is no longer supported by src/Makefile.

Expand indirect reference to copyright file to the portion of that file
that is relevant.

Bump the document date.

Crypto is now part of the "base" distribution, and the old "release.3"
target no longer exists. Renumber the old release.[4-9] targets to
release.[3-8].

Reminded by: ru

Increase the suggested minimum free space for release-building. It
needed slightly over 3GB when I built one yesterday.

The inflight sysctls have moved to net.inet.tcp.inflight.*, so adjust
documentation accordingly.

Improve the wording of the last commit, and update the document date. (1)
While here, update an example.

(1) Submitted by: ru

Document EXTSRCDIR.

Submitted by: Pawel Worach <pawel.worach@telia.com>

Remove an unnecessary comma from the Copyright.

Obtained from: DragonFly BSD

Remove the g++ include directory - it has been gone a long time
ago and add it's new incarnation c++ instead.

Add a description what is in the sub-directories of /usr/include/netnatm.

Correct a couple of language nits and a spelling.

PR: docs/68799
Submitted by: Chris Pepper <pepper@reppep.com>
MFC after: 3 days

Mechanically kill hard sentence breaks and double whitespaces.

Removed trailing whitespace.

Spelling fixes.

Assorted markup, spelling, and grammar fixes.

Add descriptions for new path, info, maint, cat, bdeps, and
rdeps variables and some new examples for "make search".

Approved by: josef (mentor)
MFC after: 2 days

Overhaul the markup.

Update for include/altq

Reminded-by: ru

s/disklabel/bsdlabel/g
Removed paragraph about "new experimental feature" the hw.ata.tags
which sysctl -a knows nothing about.
Fix typos while I'm here.

PR: docs/66493
Submitted by: Julien Gabel <jpeg@thilelli.net>

- Remove leading zero from document date [1]
- Remove entry which tells about periodical INDEX updates in
the CVS repository
- Add description for fetchindex target

Requested by: ru [1]
Approved by: josef (mentor)

- Bump the document date

Requested by: ru
Approved by: ru, josef (mentor)

- Mention new targets from bsd.port.mk:
* config
* showconfig
* rmconfig
* describe
- Add OPTIONS description
- Word smithing

PR: docs/67342
Reviewed by: ru
Approved by: josef (mentor)

Update the date.

Requested by: ru

- Add missing 'the'.
- Document /usr/include/geom/ directory and its subdirectories.

Requested by: ru

Inform hier(7) manual page about /lib/geom/ directory.

Reminded by: ru

"in in" is not always wrong (backout 1.18).

Keep the onion metaphor consistent.

Effect the correct use of "affect".

Use em dashes instead of " - ".

Use .Em instead of *emphasis*.

Note that securing root indirectly (by securing staff accounts) works
only if direct root access has been limited. [1]

s/hacker/attacker, as done in the handbook. (inspired by [1])

PR: 52878 [1]
Submitted by: Brian Minard <bminard@flatfoot.ca> [1]

Some mdoc fixes.

mdoc help from: ru
MFC after: 5 days

Sorry for doing this backwards, but as with most release related stuff
we only pay attention to it during release time and at the moment it's
a -stable release in progress.

This is a MFS I guess, moving rev 1.536.2.113 to HEAD. I ran out of
time to follow through with doing this last night. Sorry for the delay.

Adding a couple of variables to make tweaking the CD-ROM label and .iso
filenames easier.

Move the SNMP MIBs and tree definitions from /usr/share/bsnmp to
/usr/share/snmp. This mirrors the use of /usr/local/share/snmp and
makes also more sense when non-bsnmp-specific MIBs go in.

Removed more vestiges of the stl(4) driver.

More kosher mdoc(7).

Submitted by: ru

Restore part of rev 1.92; share/libdata/gcc should not have been deleted.

Remove mention of share/libdata/doscmd/{,fonts/} and share/libdata/gcc.

Added Xref to env(1).

Correct minor typos.

Remove 'broken in some cases' Xref to Kerberos.

PR: 30443
Cool with: markm (who approved this ages ago)

Clarify more about LC_*/LANG priorities.

- Catch up to new boot floppies targets.
- Update description of release.4 to mention KERNELS variable.
- Update field width for make release targets.

Use a single style for share/man/ makefiles:

- Sort MAN and MLINKS in "dictionary" order ignoring case.

- For multi-value MAN and multi-pair MLINKS, put each value/pair
on its own line, for easier sorting and so that further diffs
are easier to see.

Note that NO_FLOPPIES is i386-only.

Install UDF header files to unbreak /sbin building when /sys is not present.

Submitted by: imura@ryu16.org

Update hier(7) to reflect the world with respect to /lib and /libexec.

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

Correct the on-disc path to the porters-handbook

Document the 'fetch-recursive-list' and 'deinstall-all' targets.

No MFC reminder, I'll sync this page with the one in -stable in
a couple of days.

PR: docs/46181
Patch submitted by: Sergey Matveychuk <sem@ciam.ru>

Add the 'package-recursive' option

PR: 57838
Submitted by: Alexander Haderer <alexander.haderer@charite.de>
MFC after: 5 days

Add /usr/share/security to reflect recent hookup of Makefile and
mtree entry for share/security/lomac-policy.contexts.

Pointed out by: ru

Remove /usr/libdata/msdosfs description.

Noticed by: ru

Correct the description of what the release.3 stage does nowadays.

Make LOCAL_PATCHES accept multiple patch files, as its name suggests.

Remove invalid statement about the maximum number of swap drives.

PR: docs/55276
Submitted by: Roderick van Domburg <r.s.a.vandomburg@student.utwente.nl>

Document /var/empty as generic empty directory, not sshd specific

asami is no longer our ports lead, so remove a statement saying
the ports collection is maintained by asami and the ports team.

mdoc(7): Use the new feature of the .In macro.

Add a warning describing at least one circumstance where cvsup can hose
a local branch. Text from an email from jdp@

Reported by: simon

Add a section on maintaining a local branch in CVS.

MFC after: 1 day

Add /rescue/ and a reference to its manual page rescue(8).

Approved by: ceri (mentor)

Moved the WORLDDIR variable description to the Optional Variables section.

Move the rescue manpage, documenting the new rescue utilities in
/rescue, from section 7 to section 8. The old rescue.7 file has been
simply subjected to "cvs rm", as there is no history to preserve.

Update the release documentation accordingly.

Requested by: njl, ru
Most text by: Tim Kientzle <kientzle@acm.org>
Reviewed by: ru, doc@
Approved by: ceri (mentor)

Moved the boot floppy generation code out from release.9 to release.10.
The release.9 target is now responsible only for generation of MFS root
file systems, that are built for all architectures, even those that do
not provide a floppy installation option. The release.10 target is now
responsible for creation of a set of boot, MFS root, and fixit floppies,
and the NO_FLOPPIES variable now affects only this target.

Also, replaced the FIXIT_TARGET variable with a check of whether the
*FIXITSIZE variables are present for a given architecture, similar to
how this is done when generating boot floppies.

Discussed with: jhb

Added the WORLDDIR variable (defaulting to ${.CURDIR}/..) that
points to a directory where "make buildworld" was run. Useful
for building 5.x snapshots on 4.x.

Add manual page to document the new rescue utilities in /rescue.

Most text by: Tim Kientzle <kientzle@acm.org>
Reviewed by: ru, doc@
Approved by: ceri (mentor)

Grammar fix

PR: 54225
Submitted by: Christopher Nehren <apeiron@comcast.net>
MFC after: 3 days

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

MASTER_SITE_OVERRIDE can list several sites.

Remove the old xref to kerberos(1), and replace it with an xref to
kerberos(8). According to markm, the kerberos(8) manual page is
installed if NO_KERBEROS is set.

PR: 30443

This is a driver for the physical layer chips used in ATM interfaces.
It currently supports the PMC Sierra Lite, Ultra and 622 chips and
the IDT 77105. The driver handles media options and state in a consistent
manner for ATM drivers. The next commit to the midway driver will make
it use utopia.

Use .Ic instead of .Xr for internal commands

Assorted mdoc(7) fixes.

Kill whitespace at EOL.

Approved by: re (blanket)

Assorted mdoc(7), grammar, spelling, and punctuation fixes.

Approved by: re (blanket)

Add a reference to release(7)

Requested by: murray
Approved by: re (murray)

Sort references by section

PR: 52501
Submitted by: Simon L.Nielsen <simon@nitro.dk>
Approved by: re (scottl)
MFC after: 3 days

Make the output more consistent.

Mbits -> Mbits/s
band width -> bandwidth

PR: 39822
Submitted by: Chris Pepper <pepper@rockefeller.edu>
MFC after: 3 days

Add terse descriptions for NLSPATH and LC_*.

Note that kern.securelevel must be set to '-1' to build a release
successfully.

PR: docs/42339
MFC after: 3 days

Correctly use .Bd macro.

Document a workaround for the problem of infrastructure changes in the
doc/ tree that can cause release builds on the security branches to
break.

PR: docs/35620
MFC after: 3 days

s/loaded as a module/available as a module/g

Submitted by: ru

Make PREFETCHDISTFILES the default. Set NO_PREFETCHDISTFILES if you don't
like this. Also make it easier to issue the distfile fetching on command.

Update sendfile.2 to include a TUNING section that documents the
various tunables that are applicable to sendfile(2). Update tuning.7
to mention a reference to sendfile.2.

Approved by: keramida

KerberosIV deorbit sequence: We no longer build a krb4 distribution.

Update for kerberos 5

Remove a remnant of netns.

mdoc(7) police: Scheduled sweep.

Packages have been in .tbz format for some time now, thus s/tgz/tbz/

X-MFC after: re-approval

NODEVFS cleanup.

List all of the assignment operators explicitly, for those who have been
traumatized by perl.

Sort. Move /usr/heimdal to /var/heimdal where it really is.

PR: docs/46637
Submitted by: Igor Sobrado <sobrado@acm.org>
Approved by: ru

Some Pa fixes from Tom, plus a little rearranging of the paragraph by me.

Submitted by: Tom Rhodes

english(4) police.

Spelling: s/then/than/ where appropriate.

mdoc(7) police: Deal with self-xrefs.

mdoc(7) police: spelling, removed (scheduled again) hard sentence breaks.

A pile of patches, most notably some Doc policing by Hiten Pandya.

Add development.7

Reminded by: Sean Kelly <smkelly@zombie.org>

english(4) police.

So many people have asked me to describe my development environment that
my fingers are getting tired. Here is a new manual page, 'development',
which describes a very powerful, generic, exportable development environment
suitable to developers, sysops, admins, and anyone at all who is
maintaining more the one FreeBSD box. I have used this type of environment
for many years and have had to make virtually no changes to it for all that
time.

MFC after: 3 days

Change tcp.inflight_min from 1024 to a production default of 6144. Create
a sysctl for the stabilization value for the bandwidth delay product (inflight)
algorithm and document it.

MFC after: 3 days

Add and fix cross-references.

Prompted by: rwatson, dcs
Sponsored by: DARPA, Network Associates Labs

Uniformly refer to a file system as "file system".

Approved by: re

mdoc(7) police: Added the missing .Os call; it's not strictly
necessary nowadays, but is documented as "required", and may
become so again in the future.

Approved by: re

Remove documentation of ENABLE_VFS_IOOPT: we don't want people to use
it, so don't suggest it. It's likely going away soon also, so avoid
believing it's supported.

Suggested by: Sean Kelly <smkelly@zombie.org>
Approved by: re

Capitalize ASCII code names.

Approved by: re

Back out part of last delta that was committed by accident.
(.Xr is not yet that smart.)

mdoc(7) police: scheduled sweep.

Approved by: re

mdoc(7) police:

Revert to using the .Tn POSIX and .Tn ANSI instead of \*[Px] and \*[Ai]
strings; using these strings is unsafe in troff mode, as they include a
change in a font size.

Approved by: re

Document the KERNELS variable.

Add EXTLOCALDIR document.

Document NOCDROM and NO_FLOPPIES.

X-ref clock_gettime(2).

Correctly spell "te" as "mls".

Add a man page describing the Mandatory Access Control label format.

Obtained from: TrustedBSD Project
Sponsored by: DARPA, Network Associates Labs

Minor grammar fix: referenced to -> in reference to.

Add description of fetch-recursive target.

Refer to doc/en_US.ISO8859-1 for documentation.

Split an excessively long sentence.

Improve wording by removing repetitive use of 'default'.

The ipfw module is only loaded if necessary.

s/then/than/ where appropriate.

rulset -> ruleset

Update for BSD.include.dist r1.60 (addition of include/dev/ofw).

Forgotten by: tmm
Prodded by: ru

Add a note explaining /var/empty.

PR: docs/43364
Submitted by: Kim Scarborough <sluggo@unknown.nu>
MFC after: 14 days

Document DOC_LANG.

Reviewed by: murray

Document intptr_t and uintptr_t.

Cleanup grammer related to PR 40907 and add a section on TCP delayed
acks as suggested by Mike Harding <mvh@ix.netcom.com>

Rearrange a sentence that got stuck in the wrong paragraph.

X-MFC after: (all commits here will be MFCd)

Clear up confusion in a sentence describing [/var]/tmp.

Add a section on the net.inet.ip.portrange.* sysctls.

Suggested by: Mike Harding <mvh@ix.netcom.com>
MFC after: 3 days

Oops, last manual commit was to -stable, should have been to -current.
No biggy, the code MFC to stable will catch up to the docs in a week.

X-MFC after: -7 days

mdoc(7) police: Bump document date, removed (again) hard sentence breaks..

Correct links to Handbook's pages, old URLs does not work anymore.

MFC after: 1 week

Fix typo.

PR: docs/41091
MFC after: 1 day

Document DOCRELEASETAG and PORTSRELEASETAG.

Document PREFETCHDISTFILES.

Document KERNEL_FLAGS and WORLD_FLAGS.

- Move BUILDNAME up before CHROOTDIR.
- RELEASETAG is an optional variable, not a required one.

sec-doc.7 has been repo-copied to sdoc.7 to be consistent with sprog.7.

Sponsored by: DARPA, NAI Labs

ICMP type 3 packets should be let through for TCP MTU discovery, fixup
the documentation and sample firewall.

PR: docs/39495

Add sections on vfs.write_behind and vfs.hirunningspace. Also note that
this has already been comitted to stable (the MFC was really through
this commit, not the previous commit).

update the firewall documentation to cover the fact that ipfw can be
loaded as a module.

PR: kern/39814

Document the standard COLUMNS environment variable here to avoid redundant
descriptions of its effects in utilities' manual pages.

mdoc(7) police: added missing markup bits.

mdoc(7) police: markup nit.

mdoc(7) police: fix references to sendmail(8).

Remove, with extreme prejudice, the notion that /tmp best needs to be a
softlink to /var/tmp.

This is horribly wrong since /tmp and /var/tmp serve different goals.
Even given the text that in the old days things were different doesn't help,
since our scripts clean /tmp, and we depend on /var/tmp to persist for
vi editing sessions recovery and other likewise applications.

Keep up with BSD.usr.dist,v 1.260.

Remove reference to dead file (style.perl.7).

Pointy hat to: joe

No need to have a perl style if we've not got perl.

Catch up with BSD.usr.dist,v 1.259.

More file system > filesystem

Split release.2 into two stages. release.2 now install the base
dist, while release.3 makes and installs crypto, krb4, and krb5
dists. This makes release.3 restartable (with "make rerelease").

Document CVSCMDARGS variable.

Suggested by: murray
Reviewed by: ru
MFC after: 3 days
(if re@ allows)

Document how to "make release" for a different arch.

Obtained from: build(7)

Remove an extraneous .El call.

Submitted by: fenner

Update /usr/libdata/perl subdirectory to the Perl 5.6.1.

Add some additional sendmail related directories

MFC after: 3 days

* Correct a typo.
* Add an entry for /etc/pam.d.
* Update /usr/libdata/stallion description.

Fix misordered list.

Add stdint(7), a manual which describes some of the integer types
available in the <stdint.h> header.

Remove reference to share/dict/special/. That directory does not
exist, nor does the referenced program.

MFC after: 3 days

Add a note about the FreeBSD technical word list.

mdoc(7) police: remove whitespace at EOL.

Add drivers.conf(5) to the SEE ALSO section.

MFC after: 1 week

Don't pretend to be a section 4 man page.

Approved by: joerg

Fix a typo.

mdoc(7) police: tidy up.

mdoc(7) police: nit.

mdoc(7) police: tidy up.

mdoc(7) police: tidy up.

Spell analogous properly.

Found by: ispell(1)

* Document the 'floppies' target.
* Document the LOCAL_SCRIPT option.
* Document the NOPORTREADMES option.
* Be more specific in a comment.
* Be more specific about the ftp.1 and cdrom.1 targets.
* Clarify the usage of the CVSROOT variable.
* Clarify the usage of the NODOC variable.

Suggested by: matusita

Typo: s/compatability/compatibility/

MFC after: 3 days

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

Even more markup / whitespace fixes:
* Use .Va instead of .Ev
* Remove a trailing whitespace at EOL.
* Quote some arguments.

Submitted by: ru

NAI DBA update.

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

Various mdoc fixes.

Submitted by: ru

* Simplify the synopsis.
* Remove trailing whitespace at EOL.
* Various grammar cleanups.
* Note that MAKE_ISOS is disabled by default.
* Use more descriptive mdoc markup.
* Use proper references for the online FDP documents.

Submitted by: dd

Reference release(7) in SEE ALSO.

Add a makefile to document the release building process.
Specifically, this documents the available targets and relevant
environment variables for "make release". LOCAL_PATCHES,
RELEASEDISTFILES, RELEASENOUPDATE, etc.. are covered.

A future commit should add more information about drivers.conf,
boot_crunch.conf, and other less well-known aspects of the release
build.

Reviewed and history section added by: phk

Point readers to the Porter's Handbook instead of the non-existant
"Porting Applications" section of the FreeBSD Handbook.

MFC After: 2 days

Fix typo.

PR: docs/35422
Submitted by: Mike DeGraw-Bertsch <mbertsch@radioactivedata.org>

Two license updates.

Clarify word choice: s/those users/users/, since there is no previous
instance of 'users' to refer to.

Revert revision 1.57 -- ache@ axed /var/spool/uucp in BSD.var.dist,v 1.55.

mdoc(7) police: tidy up.

Reviewed by: chris

Change "From Id:" to the correct "$Id$" string, as there's no danger
of it being expanded.

Sponsored by: DARPA, NAI Labs

newfs -U enables softupdates beginning with FreeBSD 4.5.

PR: 33391
Submitted by: Ceri <setantae@submonkey.net>

mdoc(7) police: expand contractions, remove newly introduced
hard sentence break, revert to a proper markup for config(8)
file directives, fix broken xref.

Fix typo, and add some additional description to the i8254 and TSC.

PR: docs/20738
Submitted by: Tan Koan-Sin <freedom@csie.nctu.edu.tw>

ispell sweep of share/man/man7/*.

Minor doc nit: Replace contractions with their expanded forms.

Obtained from: NAI Labs CBOSS Project
Sponsored by: DARPA, NAI Labs

As discussed with Bruce Evans and Kirk McKusick:
o Combine ufs.7 and ffs.7 into a single ffs.7 man page.
o Remove all references to `ufs' as a file system.
o Proper (lack of) capitalization for `ffs'.

Obtained from: TrustedBSD Project
Sposnored by: DARPA, NAI Labs

Make `WHERE TO START' and `WHERE TO STOP' subsections within `DESCRIPTION'.

Suggested by: sheldonh
Obtained from: TrustedBSD Project
Sponsored by: DARPA, NAI Labs

o Logically split up sentences, removing hard sentence breaks.
o Use .Sx where a section cross-reference is intended.

Obtained from: TrustedBSD Project
Sponsored by: DARPA, NAI Labs

Be sure to point out that, by "mount point", one in /etc/fstab
is meant.

Submitted by: John Hanley <jh_@yahoo.com>
Obtained from: TrustedBSD Project
Sponsored by: DARPA, NAI Labs

Document how to enable ACLs using extattrctl.

Obtained from: TrustedBSD Project
Sponsored by: DARPA, NAI Labs

Move UFS and FFS docs to section 7.

Obtained from: TrustedBSD Project
Sponsored by: DARPA, NAI Labs

Add in the new security documentation guidelines document.

Obtained from: NAI Labs CBOSS Project
Sponsored by: DARPA, NAI Labs

o s/softupdates/it/ to reduce over-use of 'softupdates' in a single
paragraph.

o Softupdates is now enabled by default on non-root file systems. Update
language about softupdates to reference this fact, as well as slightly
moderate the "recommend Softupdates for use on all filesystems" to
"most filesystems" so as to be consistent with what sysinstall selects.

o Most users will use sysinstall(8) for partition layout, rather than
disklabel(8), so add a reference to sysinstall(8).

o Expand on the definition of a sysctl, and add cross-references to
rc.conf and sysctl.conf.

MFC after: 3 days

o Refer to hw.ata.wc as a 'loader tunable' rather than a 'kernel variable'
for consistency with the rest of the document. Since we've already
described the properties of loader tunables elsewhere, remove the
duplicate description of it being a boot-time property.

MFC after: 3 days

o Update tuning(7) to reflect auto-tuning of kern.maxusers in recent
versions of FreeBSD. This should be merged before 4.5-RELEASE, as this
functionality is present in 4.5-RELEASE.

MFC after: 3 days

mdoc(7) police: kill the undead whitespace at EOL.

o Various language and style tweaks.

Submitted by: ru

mdoc(7) police: remove the debugging stuff I use to prevent
hyphenation (so that the output could be spell-checked).

Update the default newfs block and fragment sizes from 8192/1024 to
16384/2048.

Following recent discussions on the -arch mailing list, involving dillon
and mckusick, this change parallels the one made over a decade ago when
the default was bumped up from 4096/512.

This should provide significant performance improvements for most
folks, less significant performance losses for a few folks and
wasted space lost to large fragments for many folks.

For discussion, please see the following thread in the -arch archive:

Subject: Using a larger block size on large filesystems

The discussion ceases to be relevant when the issue of partitioning
schemes is raised.

Remove the advice relating to the number of cylinders per cylinder
group. The highest possible value is calculated automatically since
rev 1.41 of src/sbin/newfs.c .

When rfc1323 is mentioned in the context of buffer sizes, not that it
is enabled by default in FreeBSD.

o Add a mention of kern.openfiles to the description of kern.maxfiles,
and suggest using this value to get a sense of the needs of the system.

o Fix spelling of allocations as allocates.

Submitted by: silby

o Reflect changed default such that keepalives are always enabled by
default now. Discuss why that's good. Note that there are still
some situations where turning it off may be advantageous, including
situations where there are network outages and it's desirable to
have TCP sessions last beyond the outage.

Reviewed by: fenner
Suggested by: silby

Moderate the recommendation that TCP keepalives always be turned on;
in some environments, this may result in the early termination of
legitimate TCP sessions during temporary network outages. However,
maintain a strong recommendation that this be used when many network
clients are dialup.

Requested by: fenner

o Add an additional .Pp between the send/recvbuffer comments and
the ones on ipfw. Note to self: why does ipfw/dummynet count as
a sysctl in tuning(7)?

o When describing kern.ipc.nsfbufs, use the slightly less colloquial
"modify" rather than the slightly more colloquial "mess with".

The default values for net.inet.tcp.sendspace and net.inet.tcp.recvspace
have been changed to 32k and 64k respectively.

vmiodirenable is now on by default; reflect that change in default,
and talk more about the reasons to turn it off (restricted memory
environments), and less about why to turn it on.

Reword parts of tuning(7) regarding loader tunables, which are refered
to in the document as "boot-time sysctls". Instead, refer to them as
loader tunables.

Spelling police: "more then" - "more than" where appropriate.

mdoc(7) police: markup nits.

mdoc(7) police: fix markup + generic cleanup.

Document the /var/run/named directory.

Suggesteded by: brian

Add a directory in /var/run to store ppp(8) command sockets.

PR: bin/29966
Approved by: brian
MFC after: 4

add /var/heimdal

absence noted by Archie Cobbs <archie@packetdesign.com>

Update tuning so that it mentions maxusers, nmbclusters, and nsfbufs as
tunables in loader.conf rather than just kernel options.

MFC after: 3 days

Improve the wording of my last commit.

Submitted by: sheldonh

Note that the contents of /tmp may or may not be kept between system
reboots.

Also add a `NOTES' section that reminds the reader that this man page
just documents the system default, and that the hierarchy of a given
site is at the system administrators discretion.

PR: docs/29525

mdoc(7) police: Use the new .In macro for #include statements.

Oops, /var/spool/uucp needs to stay for serial port locking

Note removal of UUCP directories

Note that it might not be a good idea to mount /var 'noatime'.

PR: docs/30675
Submitted by: Eugene M. Kim <gene@nttmcl.com>, and
Giorgos Keramidas <charon@labs.gr>

Update to reflect the fact that net.inet.tcp.rfc1323 is on by default.

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.

Mentions about /var/spool/secretmail were deleted in BSD.var.dist,v 1.2.

Even more libss removal.

mdoc(7) police: s/BSD/.Bx/ where appropriate.

mdoc(7) police: s/NetBSD/.Nx/ where appropriate.

mdoc(7) police: protect trailing full stops of abbreviations
with a trailing zero-width space: `e.g.\&'.

mdoc(7) police:

Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text.
Not only this slows down the mdoc(7) processing significantly, but it also
has an undesired (in this case) effect of disabling hyphenation within the
entire enclosed block.

mdoc(7) police: don't use enclosure macros with plain text.

Note which entries are created by sysinstall(8).

Requested by: ru

Fix assorted typos.

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

fix typo: vise versa -> vice versa

PR: 28926
Submitted by: Michael Lucas <mwlucas@blackhelicopters.org>

mdoc(7) police: eliminate warnings.

mdoc(7) police: sort SEE ALSO xrefs.

mdoc(7) police: removed HISTORY info from the .Os call.

Fix typo: "fending of" -> "fending off"

mdoc(7) police: remove extraneous .Pp before and/or after .Sh.

Fix type-o's, revamp section on the /tmp softlink, add sections for a
couple more sysctl's, add a section on mount options.

mdoc(7) police: sort SEE ALSO xrefs (sort -b -f +2 -3 +1 -2).

/dist is a mount point used by sysinstall(8), not an extraction directory.

Document dist/, cdrom/, compat/, and /usr/compat/, fix a couple of
{typ,think}os.

Submitted by: Rich Morin <rdm@cfcl.com>

Reword the sentence that I screwed up in the last commit.

Submitted by: Erik Trulsson <ertr1013@student.uu.se>

Remove duplicate words.

mdoc(7) police: sort xrefs.

OpenSSH doesn't forward keys by default.

Document /usr/include/dev/{ic,wi}.

Reminded by: ru

Fix type-o's, update page

Add sprog.7 to the list.

Add sprog.7, the beginnings of the secure programming guide.

Reviewed by: ru

Remove vestiges of MFS.

Add two new manual pages related to general firewall and tuning issues

Reviewed by: hackers

Document /usr/include/fs/ntfs and /usr/include/fs/nwfs.

- sys/msdosfs moved to sys/fs/msdosfs
- msdos.ko renamed to msdosfs.ko
- /usr/include/msdosfs moved to /usr/include/fs/msdosfs

Document new /usr/include/fs include subdirs.

Replace references to the KERNEL variable with KERNCONF.

Fixed typos: dependant -> dependent

Reword a few things and document the `search' and `index' make targets.

PR: 26690
Submitted by: Pete Fritchman <petef@databits.net>

mdoc(7) police: normalize .Nd.

Use Groff versions of man(7) and mdoc(7) manpages.
mdoc.samples(7) is superseded by mdoc(7).

Document /usr/include/fs/smbfs and /usr/include/netsmb.

Submitted by: bp

Record -lposix1e death.

MAN[1-9] -> MAN.

.St macro cleanup:

- spell the abbreviation of 1003.1 as ``POSIX.1''
- fixed the description of -p1003.1-90; it was sold as ISO/IEC 9945-1:1990
- removed -p1003.1b; it only existed as 1003.1b-1993 (-p1003.1b-93), and
is part of 1003.1 since 1003.1-1996.
- replaced -p1003.1g (project) with -p1003.1g-2000 (approved draft)
- changed abbreviation of -isoC from ``ISO C'' to ``ISO C89''
- removed -iso9899 alias for -isoC
- IEC was missing from some names
- added abbreviation for -susv2 (``SUSv2'')

Update the BUGS section.

The first bug is fixed in tmac.doc, revision 1.21.
The second bug fixed in doc-common, revision 1.33.

/^\.St/ s/-iso9945-1/-p1003.1-96/

Don't set a bad example by putting the function type in ".Fo".

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

Actually add build.7 to the Makefile, 2 months late.

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

o Clear up explanations of various entries (includes spelling, grammar,
punctuation, and explanations that are just plain wrong)
o Add missing entries
o Remove entries for directories that do not exist

Submitted by: Rich Morin <rdm@cfcl.com> (for the most part)

fix typo; file -> files

Submitted by: Alexey Dokuchaev <danfe@inet.ssc.nsu.ru>

Add getenv(3) and setenv(3) into ``See also'' section.

Prepare for mdoc(7)NG.

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

mdoc(7) police: removed history info from the .Os FreeBSD call.

Document /usr/include/isc.

Noticed by: ru

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

Document /usr/include/netnatm and /usr/share/sendmail.

Mention mergemaster(8).

Submitted by: obrien