[FFmpeg-cvslog] doc/indevs: make pulse dev formatting consistent with other devices

[Lukasz Marek]

ffmpeg | branch: master | Lukasz Marek <lukasz.m.luki at gmail.com> | Fri Oct  4 14:01:51 2013 +0200| [c21be5845fa6f0366ea221a9df8484fcc8f03a9f] | committer: Stefano Sabatini

doc/indevs: make pulse dev formatting consistent with other devices

Signed-off-by: Lukasz Marek <lukasz.m.luki at gmail.com>
Signed-off-by: Stefano Sabatini <stefasab at gmail.com>

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=c21be5845fa6f0366ea221a9df8484fcc8f03a9f
---

 doc/indevs.texi |   86 ++++++++++++++++---------------------------------------
 1 file changed, 24 insertions(+), 62 deletions(-)

diff --git a/doc/indevs.texi b/doc/indevs.texi
index 5cc03f9..6bcb237 100644
--- a/doc/indevs.texi
+++ b/doc/indevs.texi
@@ -485,87 +485,49 @@ For more information about OSS see:
 
 @section pulse
 
-pulseaudio input device.
+PulseAudio input device.
 
-To enable this input device during configuration you need libpulse-simple
-installed in your system.
+To enable this output device you need to configure FFmpeg with @code{--enable-libpulse}.
 
 The filename to provide to the input device is a source device or the
 string "default"
 
-To list the pulse source devices and their properties you can invoke
+To list the PulseAudio source devices and their properties you can invoke
 the command @command{pactl list sources}.
 
- at example
-ffmpeg -f pulse -i default /tmp/pulse.wav
- at end example
-
- at subsection @var{server} AVOption
-
-The syntax is:
- at example
--server @var{server name}
- at end example
-
-Connects to a specific server.
-
- at subsection @var{name} AVOption
-
-The syntax is:
- at example
--name @var{application name}
- at end example
-
-Specify the application name pulse will use when showing active clients,
-by default it is the LIBAVFORMAT_IDENT string
-
- at subsection @var{stream_name} AVOption
-
-The syntax is:
- at example
--stream_name @var{stream name}
- at end example
-
-Specify the stream name pulse will use when showing active streams,
-by default it is "record"
+ at subsection Options
+ at table @option
+ at item server
+Connect to a specific server. Default server is used when not provided.
 
- at subsection @var{sample_rate} AVOption
+ at item name
+Specify the application name PulseAudio will use when showing active clients,
+by default it is the @code{LIBAVFORMAT_IDENT} string.
 
-The syntax is:
- at example
--sample_rate @var{samplerate}
- at end example
+ at item stream_name
+Specify the stream name PulseAudio will use when showing active streams,
+by default it is "record".
 
+ at item sample_rate
 Specify the samplerate in Hz, by default 48kHz is used.
 
- at subsection @var{channels} AVOption
-
-The syntax is:
- at example
--channels @var{N}
- at end example
-
+ at item channels
 Specify the channels in use, by default 2 (stereo) is set.
 
- at subsection @var{frame_size} AVOption
+ at item frame_size
+Specify the number of bytes per frame, by default it is set to 1024.
 
-The syntax is:
- at example
--frame_size @var{bytes}
- at end example
-
-Specify the number of byte per frame, by default it is set to 1024.
-
- at subsection @var{fragment_size} AVOption
+ at item fragment_size
+Specify the minimal buffering fragment in PulseAudio, it will affect the
+audio latency. By default it is unset.
+ at end table
 
-The syntax is:
+ at subsection Examples
+Record a stream from default device:
 @example
--fragment_size @var{bytes}
+ffmpeg -f pulse -i default /tmp/pulse.wav
 @end example
 
-Specify the minimal buffering fragment in pulseaudio, it will affect the
-audio latency. By default it is unset.
-
 @section sndio
 
 sndio input device.