Copy head@r302406 to stable/11 as part of the 11.0-RELEASE cycle.
Prune svn:mergeinfo from the new branch, as nothing has been merged
here.

Additional commits post-branch will follow.

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

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

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

Found by: mdocml lint run
Reviewed by: ru

Convert to use a SYNPOSIS section that mentions kernel modules.
Also add "device scbus" where needed.

MFC after: 3 days

Add a HARDWARE section which lists supported devices. The actual
device listings has been moved (and in some cases more or less
rewritten) from the DESCRIPTION section.

This will be used later for automatically generating device listings
in the Hardware Notes, by parsing the manual pages.

Reviewed in principle by: ru, hrs, trhodes
No objections: -doc, re
Section name inspired by: NetBSD

Update list of supported devices for ahb

Hiten's patchset for section four manpages, slightly edited by me.

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

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>

Update the aha(4) and ahb(4) man pages for CAM.

Reviewed by: ken
Submitted by: gibbs

.Sh AUTHOR -> .Sh AUTHORS according to mdoc specs.
Use .An/.Aq.

add missing cvs Id lines.

Correct the synopsis of some EISA or PCI drivers. They don't take
ISA-like arguments (anymore).

More man page cleanups.

To celibrate the new status of the ahc driver, give it a man page.

Add references to the ahc driver to the other adaptec man pages.

Remove the "NOTE" section of the ahb man page that complained about
Adaptec's NDA policy preventing 274x driver development.

Changed all occurences of GENERICAH/GENERICBT to a simple GENERIC in the
man pages.

Change hardwired irqs to soft irqs (?).
Add manpage for Buslogic cards, since we didn't have one.

Add new files from Wilko (and in their proper place).
Submitted by: Wilko Bulte