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

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

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

MFC after: 3 days

Sort sections.

Move listing of DTC 3290 to aha(4).

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

Assorted markup, spelling, and grammar fixes.

Forced commit:

Last commit moved info about the aha-1640 card. It also added notes
about the fact that the A card is busted (and likely will never be
fixed) and the B card doesn't work well on heavy load.

Add the meteor driver man page back. It has moved up a level from the
man4.i386. It documents that meteor no longer works, but keeps the
extensive documentation on the meteor interface, which the bktr driver
implements also. This should be merged into tha man page, but such a
merging seems to be planned by others.

# we really need something like video4bsd to define these sorts of
# things for all video capture drivers.

Requested by: rwatson and obrien

o Update to closer to the official names for these cards.
o Remove entries for 1510, 152x and 1535. These are supported, for some value
of supported, by the aic driver.
o Add notes about 1542-CP being plug and play, but it can still conflict with
other resources because all the resources it uses are set with the onboard
BIOS.

Catch up aha(4) manpage with hardware notes and driver code.

(While applying this patch from the PR, delete a stray comma.)

PR: 55527
Submitted by: Lukas Ertl <l.ertl@univie.ac.at>

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.

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: do not split author names in the AUTHORS section.

Remove stray "cam" in the example device lines.

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

add missing cvs Id lines.

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