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

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

General mdoc(7) and typo fixes.

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

Remove trailing whitespace per mdoc lint warning

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

Update snd_cmi, snd_csa and snd_emu10kx status.

Add driver for the RME HDSPe AIO/RayDAT sound cards -- snd_hdspe(4).
Cards are expensive and so rare, so leave the driver as module.

Submitted by: Ruslan Bukin <br@bsdpad.com>
MFC after: 2 weeks

Document the values for hw.snd.default_auto.

I've rewritten most of this file so assign the copyright to me.

Approved by: re (kib)

mdoc(7) fix for the pcm(4) manual

Spotted by: manlint
Approved by: re (kib)

Add a better description, a few examples and a couple of minor fixes.

Reviewed by: brueffer
Approved by: re (kib)

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>

Fix typos and spelling mistakes.

Fix a bunch of typos and spelling mistakes.

Use the newly brought %U macro.

Fix a few language nits.

Submitted by: Ben Kaduk <minimarmot@gmail.com>
Approved by: re (blanket)

Document the new multichannel support.

Reviewed by: ariff
Approved by: re (blanket)

Adjust the description of hw.snd.feeder_rate_polyphase_max and
hw.snd.compat_linux_mmap a bit.

Submitted by: ariff
Approved by: re (blanket)

Fix two typos and sort sysctls.

PR: docs/136408
Approved by: re (blanket)

Document the new EQ and VPC features along with a few loader tunables.

Reviewed by: ariff
Approved by: re (blanket)

Add one more reference to SEE ALSO. Sort while here.

Submitted by: ariff

Bring in a few mdoc/language fixes.

Submitted by: ru

Start documenting some of the new sound stuff. More is on the way.
Probably also needs some more mdoc love.

Reviewed by: ariff

- Remove obsolete and confusing comment about renaming "sound" to "snd".
We will look at renaming stuff for 9.0, but it's far from certain that we
will do it this way.
- Sort sysctl's alphabetically. I'll add a bunch of new sysctl's once
ariff's next mega-patch goes in, and having everything sorted makes my
job easier.

Document two new sysctls: hw.snd.compat_linux_mmap and hw.snd.default_auto.

Reviewed by: ariff
Approved by: re (hrs)

Document recent improvements to the sound infrastructure (virtual recording
channels, changed sysctl's and device nodes etc).

Reviewed by: ariff

Add the dev.pcm.%d.polling sysctl and a short description.

Reviewed by: ru

- Update the Runtime Configuration, FILES and DIAGNOSTICS sections to
the new world order.
- Use our standard section 4 SYNOPSIS.
- Minor nits.

Reviewed by: brueffer, ariff

- Use our standard section 4 SYNOPSIS layout.
- Add a bunch of missing Xrefs's.

Xref snd_hda(4).

- Remove the comment about WSS/MSS cards being the best supported
cards on the market.
- Remove the entire HARDWARE section. It's superfluous since all
snd_* manual pages have their own HARDWARE sections these days.

Reviewed by: brueffer

Fix a couple typos.

PR: docs/89881
Submitted by: Seán Farley <sean-freebsd@farley.org>
Approved by: trhodes (mentor)
MFC after: 3 days

Xref snd_atiixp.4

- Xref snd_mss(4).
- Remove a few items from the HARDWARE list. This support is
already described in the snd_mss(4) manual page.

Bump .Dd before someone notice.

Approved by: brueffer (mentor)

Remove a few items from the hardware list. This support is already
covered in the manual pages for each bridge device driver.

Approved by: brueffer (mentor)

Xref snd_t4dwave(4).

Approved by: brueffer (mentor)

- Add a HARDWARE section based on the previous 'Supported Cards'
subsection and the hardware notes.
- Xref all snd_* drivers

MFC after: 1 week

Sort sections.

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

mdoc(7) fixes.

Document the possibility to set default values for pcm mixer channels
by setting appropriate hints.

E.g.: hint.pcm.0.line="0"

Reviewed by: ru

Assorted markup, spelling, and grammar fixes.

Minor word tweaks.

Submitted by: Mathew Kanner <mat@cnd.mcgill.ca>

Bring in a 90% rewrite of the pcm.4 manual page. This adds tunables, loader
options, information on VCHANs, and more.

Based on content submitted by: Mathew Kanner <mat@cnd.mcgill.ca> && Cameron Grant
Update requested by: ru, and I think hmp

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

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

Delete MAKEDEV references and update the text about /dev/foo control
devices that return the next available device when opened.

PR: 50280, 50281, 50282, 50283
Submitted by: Sergey A.Osokin <osa@FreeBSD.org.ru>

mdoc(7) police: sort xrefs in SEE ALSO.

Update the pcm(4) manual page to explain devfs, fix a grammar error and
cross-ref devfs(5).

Approved by: re (jhb)

mdoc(7) police: anchor punctuation.

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: remove extraneous .Pp before and/or after .Sh.

Fix typo.

Approved by: tanimura

Prepare for mdoc(7)NG.

Minor doc tweaks: reorder the "SEE ALSO" section alphabetically; add
punctuation.

Remove the warning about recording on the Solo. The workarounds appear
to clear up the hwptr problems.

Fix hard sentence break and inappropriate use of the Pa macro in
the previous delta.

Document support for the Solo 1.

Requested by: sheldonh

Rework the FILES section to cover the list of common symbolic links
in the /dev directory. Also cover this driver's quirky relationship
with the MAKEDEV script.

Add an MLINKS entry which makes snd(4) a link for pcm(4).

Suggested by: Udo Erdelhoff <ue@nathan.ruhr.de>

Add a FILES section which, as a side-effect, just so happens to
give device node creation instructions.

PR: 20060
Reported by: "Sean O'Connell" <sto@stat.Duke.EDU>

Move the Nm macro from the middle of a sentence onto its own line.

Submitted by: Brian Handy <handy@lambic.physics.montana.edu>

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.

-mdoc'ify.

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.

* remove i386 specific mark
* some style and syntax fixes
* some duplicated $FreeBSD$ tags removed

Update the instructions for setting up audio symlinks, now that MAKEDEV
DTRT (well, it's been doing it since rev 1.97).

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

Remove bio/cam/net/tty labels.

OKed by: peter

Typo fix.

PR: docs/10348
Submitted by: Chris Costello <chris@holly.dyndns.org>

Removed all `vector xxxintr' specifications. Interrupt handlers are now
configured in drivers.

New man page for pcm(4) driver. Me, I think this is more likely
generic and should go one level up, but it can keep the sb(4) man
page company for now until somebody moves all the no-longer-x86-specific
driver man pages up some day.
Submitted by: luigi