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

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

mdoc: minor Bl improvements.

General mdoc(7) and typo fixes.

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

Remove superfluous paragraph macro.

Rewrite jack presence detection and implement automatic recording source
selection in snd_hda(4) driver.

Now driver tracks jack presence detection status for every CODEC pin. For
playback associations, when configured, that information, same as before,
can be used to automatically redirect audio to headphones. Also same as
before, these events are used to track digital display connection status
and fetch ELD. Now in addition to that driver uses that information to
automatically switch recording source of the mixer to the connected input.

When there are devices with no jack detection and with one both connected,
last ones will have the precedence. As result, on most laptops after boot
internal microphone should be automatically selected. But if external one
(for example, headset) connected, it will be selected automatically.
When external mic disconnected, internal one will be selected again.

Automatic recording source selection is enabled by default now to make
recording work out of the box without touching mixer. But it can be
disabled or limited only to attach time using hint.pcm.X.rec.autosrc loader
tunables or dev.pcm.X.rec.autosrc sysctls.

MFC after: 2 months
Sponsored by: iXsystems, Inc.

Major snd_hda driver rewrite:
- Huge old hdac driver was split into three independent pieces: HDA
controller driver (hdac), HDA CODEC driver (hdacc) and HDA sudio function
driver (hdaa).
- Support for multichannel recording was added. Now, as specification
defines, driver checks input associations for pins with sequence numbers
14 and 15, and if found (usually) -- works as before, mixing signals
together. If it doesn't, it configures input association as multichannel.
- Signal tracer was improved to look for cases where several DACs/ADCs in
CODEC can work with the same audio signal. If such case found, driver
registers additional playback/record stream (channel) for the pcm device.
- New controller streams reservation mechanism was implemented. That
allows to have more pcm devices then streams supported by the controller
(usually 4 in each direction). Now it limits only number of simultaneously
transferred audio streams, that is rarely reachable and properly reported
if happens.
- Codec pins and GPIO signals configuration was exported via set of
writable sysctls. Another sysctl dev.hdaa.X.reconfig allows to trigger
driver reconfiguration in run-time.
- Driver now decodes pins location and connector type names. In some cases
it allows to hint user where on the system case connectors, related to the
pcm device, are located. Number of channels supported by pcm device,
reported now (if it is not 2), should also make search easier.
- Added workaround for digital mic on some Asus laptops/netbooks.

MFC after: 2 months
Sponsored by: iXsystems, Inc.

Fix some wording and grammar in the BUGS section.

PR: docs/157901
Submitted by: Niclas Zeising (niclas dot zeising at gmail dot com)
Reviewed by: mav
MFC after: 3 days

mdoc: drop redundant .Pp and .LP calls

They have no effect when coming in pairs, or before .Bl/.Bd

Fix a bunch of typos and spelling mistakes.

Add "MIXER CONTROLS" chapter.

Update, reflecting added multichannel playback support.

Remove part that HDMI is not implemented. It had different meaning and
confuse users.
Extend BUGS section.
Add some supported chipsets.

Fix spelling a bit.

Update date.

Add some more supported controller and codec models.
Add one more proposition to check correct PCM audio device usage.

Cross-reference snd_ich and snd_hda man pages.
Some hardware require different drivers depending on implementation,
that may confuse users.

Spell 'different' correctly.

Two minor fixes.

A lot of spelling fixes.

Submitted by: keramida

Improve driver operation example description.

Fix month mistake. Again. Sorry. :)

Add hint.hdac.%d.msi description.

Add hint about hw.snd.default_unit sysctl.

Fix small mistake.

Bump modification date.

Fix a typo.

Add set of snd_hda driver configuration examples to the man page.

Minor language fixes and updates to the hardware section.

Update man page according to r182999 snd_hda driver update.

Update HARDWARE section.

- This driver will first appear in 6.3, not 7.0

MFC after: 0 days

Document support for Intel 82801I and Realtek ALC268.

Approved by: re

- Document support for Realtek ALC660 and Analog Devices AD1988B.
- Fix minor typos.

Forgot to bump .Dd

Document more quirks and supported codecs.

Add Sigmatel STAC9271D.

Add missing comma.

Noticed by: ru

- Add a small section on boot-time configuration.
- Add more Xrefs.
- Fix minor nits.

Reviewed by: ru

Add Realtek ALC888 and Sigmatel STAC9227 to the HARDWARE section.

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

Reviewed by: ru

Update the list of codecs as well...

Update list of supported hardware.

Add a manual page for snd_hda(4) and hook it up to the build.

Reviewed by: brueffer, ariff