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

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

We just have one generic sound driver, reflect this.

MFC after: 3 days

Make the SYNOPSIS section a bit more informative.

soundcard -> sound card

MFC after: 3 days

Sort sections.

Add a HARDWARE section which lists supported devices.

Update sound-related manpages to account for the recent change in
device and module naming. The following files were repo-copied:

csa.4 -> snd_csa.4
gusc.4 -> snd_gusc.4
maestro3.4 -> snd_maestro3.4
sbc.4 -> snd_sbc.4
uaudio.4 -> snd_uaudio.4

The pcm(4) manpage wasn't renamed to sound(4) as there are nearby
plans to rename "device sound" to "device snd", to address the
ambiguity in naming, so pcm.4 is linked to sound.4 for the moment.
(We also mumble something about the future plans in the manpage.)

Removed links from pcm.4 to als4000.4 and emu10k1.4 -- they now
have their own snd_*.4 manpages.

Fixes for recent snd_*.4 manpages: added missing "device sound"
to the SYNOPSIS, fixed hints (they are still "hint.pcm.<unit>"
in most cases).

MT5 after: 3 days

Mechanically kill hard sentence breaks and double whitespaces.

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.

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

mdoc(7) police: properly use a -diag list in the DIAGNOSTICS section.

Reviewed by: ru

Prepare for mdoc(7)NG.

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.

First round of config related changes to the manpages.

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

- Add the man pages for sound card bridge drivers.
(sbc(4), gusc(4), csa(4))
- Update pcm(4) for newpcm.