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

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

mdoc: fix column names, indentation, column separation within each row, and
quotation. Also make sure we have the same amount of columns in each row as
the number of columns we specify in the head arguments.

Reviewed by: brueffer

Remove superfluous paragraph macro.

o Convert to our new SYNOPSIS layout
o Add "device scbus/pci/etc" where needed for consistency

MFC after: 3 days

Sort sections.

Bump document date for last commit.

- Add a HARDWARE section which lists supported devices based on the
manual page and the Hardware Notes.

Update man pages in the section 4 to match the reality in -CURRENT.

- Change lines referring to kernel configuration file:
device foo0 at isa port xxx irq yyy...
to
device foo
Describe resource "hints" in /boot/device.hints.

- Try to describe resource allocation and probe/attach behavior in the
newbus framework.

Revert my queueing -> queuing commit. Both spellings are correct, and
some people prefer the former.

Submitted by: ken, nectar

Spelling police: queueing -> queuing

PR: 29985
Submitted by: Joseph Mallett <jmallett@xMach.org>

Spelling police: withough -> without

Submitted by: Joseph Mallett <jmallett@xMach.org>

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

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

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

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

Remove the MD part from the document title.

Forgotten by: obrien

mdoc(7) police: Change -filled displays (which just happen
to be the same as -ragged in the current implementation) to
-ragged. With mdocNG, -filled displays produce the correct
output, formatted and justified to both margins.

mdoc(7) police: do not split author names in the AUTHORS section.

mdoc(7) police: use the new features of the Nm macro.

Use Fx macro wherever possible.

Add references to new device support.

Remove stray "cam" in the example device lines.

Third round of config related changes to the manpages.

device blah0 -> device blah for PCI devices and busses.

Discourage usage of controller in kernel config files. Reflect this
by changing ``controller'' to ``device'' as per GENERIC and LINT.

$Id$ -> $FreeBSD$

Various man page cleanup:

- Sort xrefs
- FreeBSD.ORG -> FreeBSD.org
- Be consistent with section names as outlined in mdoc(7).
- Other misc mdoc cleanup.

PR: doc/13144
Submitted by: Alexey M. Zelkin <phantom@cris.net>

Add in the adv(4) and adw(4) man pages for the AdvanSys narrow and wide
SCSI controllers, respectively.

Once these drivers are tested on the alpha, these man pages can probably be
moved up a directory to reflect the fact that they're architecture
independent.

An mdoc guru should probably look at the AUTHORS sections in both of these
pages -- the .An macro seems to cause strange spacing problems.

Reviewed by: ken
Submitted by: gibbs