This patch is a cleanup of EMU1010 dock probing code in emu10k1 driver
to use work instead of kthread in a loop.  The work is lighter and
easier to control than kthread, in general.

Instead of a loop with the explicit sleep, we do simply
delayed-schedule the work.  At suspend/resume callbacks, the work is
canceled and restarted, respectively.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

The EMU1010 support in emu10k1 driver has two request_firmware()
calls, one for the main board and one for the dock.  Both call
patterns are fairly similar, and we can simplify it by introducing a
helper function and a table instead of the open switch/case.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

The emu1010_firmware_thread() checks the previous dock status, but a
wrong register is recorded as the last status when the dock is plugged
in.  Usually this isn't a big issue since this value gets overwritten
by the next loop after one second.  But when a dock is unplugged
immediately after plugging, it means essentially missing undock
handling.

This patch addresses it by remembering the correct register value.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Several lines in sound/core.h get the kernel-doc warnings like

  ./include/sound/core.h:323: warning: No description found for parameter '...'

where we use define like foo(x, args...) and "args" isn't mentioned in
the comments.  As an easy workaround, use simple __VA_ARGS__ for VLA
in macros.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Some fields in struct snd_compr have no corresponding comments, and
the kernel-doc complains like:

  ./include/sound/compress_driver.h:162: warning: No description found for parameter 'id[64]'
  ./include/sound/compress_driver.h:162: warning: No description found for parameter 'proc_root'
  ./include/sound/compress_driver.h:162: warning: No description found for parameter 'proc_info_entry'

Actually all these are internal elements, just put "private:" comment
so that they will be ignored.
Acked-by: NVinod Koul <vinod.koul@intel.com>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Sphinx takes a word like (*foo)->bar in the kernel-doc comments as a
part of the emphasized marker, and complains like

  ./sound/pci/ac97/ac97_codec.c:1908: WARNING: Inline emphasis start-string without end-string.

For avoiding this, wrap it with the quotes (``) in the comment.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Signed-off-by: NFabian Frederick <fabf@skynet.be>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Signed-off-by: NFabian Frederick <fabf@skynet.be>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Signed-off-by: NFabian Frederick <fabf@skynet.be>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Signed-off-by: NFabian Frederick <fabf@skynet.be>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Yet another simple conversion from a plain text file.
Renamed to codec-to-codec.rst to align with others.
Acked-by: NMark Brown <broonie@kernel.org>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Merge branch 'topic/doc' of git://git.kernel.org/pub/scm/linux/kernel/git/broonie/sound into topic/restize-docs

A simple conversion from a plain text file.
The file name was renamed to lower letters to align with others.
Acked-by: NMark Brown <broonie@kernel.org>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.
Acked-by: NMark Brown <broonie@kernel.org>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.
Acked-by: NMark Brown <broonie@kernel.org>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.
The file name was changed from "pops_clicks" to "pops-clicks" to align
with others.
Acked-by: NMark Brown <broonie@kernel.org>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.
Acked-by: NMark Brown <broonie@kernel.org>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.
Acked-by: NMark Brown <broonie@kernel.org>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.
The section numbers and the item numbers are dropped to align with the
ReST format.  Some lists are converted to description lists to be
clearer.
Acked-by: NMark Brown <broonie@kernel.org>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file with slight reformatting /
corrections.

The file name was changed to lower letters to align with others.
Acked-by: NMark Brown <broonie@kernel.org>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.
The section numbers are dropped to align with other documents.
Acked-by: NMark Brown <broonie@kernel.org>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.
Created a new subdirectory, Documentation/sound/soc, for this and
other ASoC documents.

Since the index page contains the TOC, so "Documentation" section got
removed from overview.
Acked-by: NMark Brown <broonie@kernel.org>
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Yet another simple conversion from a plain text file.
Put to cards directory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Yet another simple conversion from a plain text file.
Put to cards directory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.  Quite a few reformatting
in the end due to the style of the original document.

Put to cards directory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Another	simple conversion from a plain text file.
Put to cards directory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Another	simple conversion from a plain text file.
Put to cards directory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Another simple conversion from a plain text file.
Put to cards directory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Another simple conversion from a plain text file.
Put to cards directory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Another simple conversion from a plain text file.
Put to cards directory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Another simple conversion from a plain text file.
Put to cards directory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Another simple conversion from a plain text file.
Put to cards subdirectory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

Another simple conversion from a plain text file.
Put to cards subdirectory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.
Put to cards subdirectory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A conversion from a simple text file.
A new subdirectory, cards, was created to contain the card-specific
information like this one.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.
Put to designs subdirectory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.
Put to designs subdirectory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>

A simple conversion from a plain text file.
Put to designs subdirectory.
Signed-off-by: NTakashi Iwai <tiwai@suse.de>