rewrite (much ;), no content change

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@7289 b3059339-0415-0410-9bf9-f77b7e298cf2

1 files changed, 1227 insertions, 882 deletions

diff --git a/DOCS/mplayer.1 b/DOCS/mplayer.1
index ec9afc47ac..a73c8e9f09 100644
--- a/DOCS/mplayer.1
+++ b/DOCS/mplayer.1
@@ -12,7 +12,7 @@
 .nr IN 7
 ..
 .\" define indentation for suboptions
-.nr SS 18
+.nr SS 20
 ..
 .\" add new suboption
 .de IPs
@@ -53,16 +53,19 @@ mencoder \- Movie Encoder for Linux
 .RI [options]\ [ \ file\  | \ URL\  | \ playlist\  | \ -\  ]
 .br
 .B mplayer
-.RI [global\ options] \ file1\  [specific\ options]\ [file2]\ [specific\ options]
+.RI [global\ options] \ file1\  [specific\ options]\ [file2]\ \
+[specific\ options]
 .br
 .B mplayer
-.RI [global\ options]\ { group\ of\ files\ and\ options }\ [group\ specific\ options]
+.RI [global\ options]\ { group\ of\ files\ and\ options }\ \
+[group\ specific\ options]
 .br
 .B mplayer
 .RI [ dvd | vcd | cdda | cddb | tv ] ://title\  [options]
 .br
 .B mplayer
-.RI [ mms | mmst | http | http_proxy | rtp | rtsp ] :// [user:passwd@] URL [:port]\ [options]
+.RI [ mms[t] | http | http_proxy | rt[s]p ] :// [user:passwd@] URL [:port]\ \
+[options]
 .br
 .B mencoder
 .RI [options]\ [ \ file\  | \ URL\  | \ -\  ]\ [\-o\ file]
@@ -77,34 +80,37 @@ mencoder \- Movie Encoder for Linux
 .SH DESCRIPTION
 .B mplayer
 is a movie player for LINUX (runs on many other Unices, and non\-x86
-CPUs, see the documentation). It plays most MPEG/VOB, AVI, OGG/OGM, VIVO, ASF/WMA/WMV, QT/MOV/MP4,
-FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ files, supported by many native, XAnim, and
-Win32 DLL codecs. You can watch VideoCD, SVCD, DVD, 3ivx, DivX 3/4/5 and even WMV
-movies, too (without the avifile library).
-.P
-Another great feature of mplayer is the wide range of supported output drivers.
-It works with X11, XV, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you can use
-GGI, SDL (and this way all their drivers), VESA (on every VESA compatible card, even
-without X11!) and some low level card-specific drivers (for Matrox, 3Dfx and ATI), too!
-.br
-Most of them support software or hardware scaling, so you can enjoy movies in fullscreen.
-MPlayer supports displaying through some hardware MPEG decoder boards, such as the Siemens
-DVB, DXR2 and DXR3/Hollywood+!
-.P
+CPUs, see the documentation). It plays most MPEG/VOB, AVI, OGG/OGM, VIVO,
+ASF/WMA/WMV, QT/MOV/MP4, FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ files,
+supported by many native, XAnim, and Win32 DLL codecs. You can watch VideoCD,
+SVCD, DVD, 3ivx, DivX 3/4/5 and even WMV movies, too (without the avifile
+library).
+.PP
+Another great feature of mplayer is the wide range of supported output
+drivers. It works with X11, XV, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB,
+but you can use GGI, SDL (and this way all their drivers), VESA (on every VESA
+compatible card, even without X11!) and some low level card-specific drivers
+(for Matrox, 3Dfx and ATI), too!
+.br
+Most of them support software or hardware scaling, so you can enjoy movies in
+fullscreen. MPlayer supports displaying through some hardware MPEG decoder
+boards, such as the Siemens DVB, DXR2 and DXR3/Hollywood+!
+.PP
 MPlayer has an onscreen display (OSD) for status information, nice big
 antialiased shaded subtitles and visual feedback for keyboard controls.
 European/ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
 fonts are supported along with 9 subtitle formats (MicroDVD, SubRip,
 SubViewer, Sami, VPlayer, RT, SSA, AQTitle and our own: MPsub). DVD subtitles
 (SPU streams, VobSub and Closed Captions) are supported.
-.P
+.PP
 .B mencoder
 (MPlayer's Movie Encoder) is a simple movie encoder, designed to
 encode MPlayer-playable movies (see above) to other MPlayer-playable formats
-(see below). It encodes to DivX4 (1, 2 or 3 passes), XviD, codecs of libavcodec,
-PCM/MP3/VBRMP3 audio. It also has stream copying abilities, a powerful plugin system
-(crop, expand, flip, postprocess, rotate, scale, add/remove noise, rgb/yuv conversion) and more.
-.P
+(see below). It encodes to DivX4 (1, 2 or 3 passes), XviD, codecs of
+libavcodec, PCM/MP3/VBRMP3 audio. It also has stream copying abilities, a
+powerful plugin system (crop, expand, flip, postprocess, rotate, scale,
+add/remove noise, rgb/yuv conversion) and more.
+.PP
 .B gmplayer
 is MPlayer with a graphical user interface.
 It has the same options as MPlayer.
@@ -121,14 +127,14 @@ Every "flag" option has a "noflag" counterpart, e.g. the opposite of the \-fs
 option is \-nofs.
 .br
 You can put all of the options in a config file which will be read every time
-mplayer is run. The system-wide config file 'mplayer.conf' is in your configuration
-directory (e.g. /etc/mplayer or /usr/local/etc/mplayer), the user specific
-one is '~/.mplayer/config'. User specific options override system-wide options
-and options given on the command line override either. The syntax of the config
-files is 'option=<value>', everything after a '#' is considered a comment.
-Options that work without values can be enabled by setting them to 'yes' or '1'
-and disabled by setting them to 'no' or '0'. Even suboptions can be specified
-in this way.
+mplayer is run. The system-wide config file 'mplayer.conf' is in your
+configuration directory (e.g. /etc/mplayer or /usr/local/etc/mplayer), the
+user specific one is '~/.mplayer/config'. User specific options override
+system\-wide options and options given on the command line override either.
+The syntax of the config files is 'option=<value>', everything after a '#' is
+considered a comment. Options that work without values can be enabled by
+setting them to 'yes' or '1' and disabled by setting them to 'no' or '0'.
+Even suboptions can be specified in this way.
 
 .I EXAMPLE:
 .br
@@ -147,15 +153,16 @@ mf= type=png:fps=25
 
 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
 .TP
-.B \-autoq <quality> (use with -vop pp!)
+.B \-autoq <quality> (use with \-vop pp!)
 Dynamically changes the level of postprocess, depending on spare CPU time
 available. The number you specify will be the maximum level used. Usually you
-can use some big number. You may not use it together with \-pp but it is OK with
-\-npp!
+can use some big number. You may not use it together with \-pp but it is OK
+with \-npp!
 .TP
 .B \-benchmark
 Prints some statistics on CPU usage and dropped frames at the end.
-Used in combination with \-nosound and \-vo null for benchmarking only video codec.
+Used in combination with \-nosound and \-vo null for benchmarking only video
+codec.
 .TP
 .B \-dapsync (OBSOLETE)
 Use alternative A/V sync method.
@@ -172,29 +179,36 @@ More intense frame dropping (breaks decoding). Leads to image distortion!
 .TP
 .B \-input <commands>
 This option can be used to configure certain parts of the input system.
-Relative path are relative to $HOME/.mplayer. Available commands are:
-
-    conf=<file>  Read alternative input.conf.
-                 If given without pathname,
-                 $HOME/.mplayer is assumed.
-    ar\-delay     Delay in msec before we start
-                 to autorepeat a key
-                 (0 to disable).
-    ar\-rate      How many key presses/second when
-                 we autorepeat.
-    keylist      Prints all keys that can be
-                 bound to.
-    cmdlist      Prints all commands that can
-                 be bound.
-    js\-dev       Specifies the joystick device
-                 to use
-                 (default is /dev/input/js0).
+Relative path are relative to $HOME/.mplayer.
 
 .I NOTE:
+.br
 Autorepeat is currently only supported by joysticks.
+.br
+Available commands are:
+
+.PD 0
+.RSs
+.IPs conf=<file>
+Read alternative input.conf. If given without pathname, $HOME/.mplayer is
+assumed.
+.IPs ar\-delay
+Delay in msec before we start to autorepeat a key (0 to disable).
+.IPs ar\-rate
+How many key presses/second when we autorepeat.
+.IPs keylist
+Prints all keys that can be bound to.
+.IPs cmdlist
+Prints all commands that can be bound.
+.IPs js\-dev
+Specifies the joystick device to use (default is /dev/input/js0).
+.RE
+.PD 1
+.
 .TP
 .B \-lircconf <config\ file>
-Specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc.
+Specifies a configfile for LIRC (see http://www.lirc.org) if you don't like
+the default ~/.lircrc.
 .TP
 .B \-loop <number>
 Loops movie playback <number> times. 0 means forever.
@@ -218,9 +232,18 @@ Display less output, status messages.
 Load skin from this directory (WITHOUT path name!).
 
 .I EXAMPLE:
-    \-skin fittyfene  tries these:
-                        /usr/local/share/mplayer/Skin/fittyfene
-                        ~/.mplayer/Skin/fittyfene
+.PD 0
+.RSs
+.IPs "\-skin fittyfene"
+tries these:
+.RSss
+/usr/local/share/mplayer/Skin/fittyfene
+.br
+~/.mplayer/Skin/fittyfene
+.REss
+.RE
+.PD 1
+.
 .TP
 .B \-slave \ \ 
 This option switches on slave mode. This is intended for use
@@ -246,7 +269,8 @@ Turns off xscreensaver at startup and turns it on again on exit.
 .SH "DEMUXER/STREAM OPTIONS"
 .TP
 .B \-aid <id> (also see \-alang option)
-Select audio channel [MPG/SUB: 0\-31 AVI/OGM: 1\-99 ASF/RM: 0\-127 VOB: 128\-159 LPCM: 160\-191]
+Select audio channel [MPG/SUB: 0\-31 AVI/OGM: 1\-99 ASF/RM: 0\-127
+VOB: 128\-159 LPCM: 160\-191]
 .TP
 .B \-alang <two letter\ country\ code> (also see \-aid option)
 Works only for DVD playback! Selects DVD audio language. It always tries
@@ -254,9 +278,13 @@ to play audio streams whose language matches the given code. For the list of
 available languages, use with the \-v switch and look at the output.
 
 .I EXAMPLE:
-    \-alang hu,en  Plays Hungarian and falls back to
-                  English if Hungarian is not
-                  available.
+.PD 0
+.RSs
+.IPs "\-alang hu,en"
+Plays Hungarian and falls back to English if Hungarian is not available.
+.RE
+.PD 1
+.
 .TP
 .B \-audio\-demuxer <number> (\-audiofile only)
 Force audio demuxer type for \-audiofile.
@@ -270,46 +298,50 @@ Play audio from an external file (WAV, MP3 or Ogg Vorbis).
 Override default CDROM drive name /dev/cdrom.
 .TP
 .B \-cache <kbytes>
-This option specifies how much memory (in kbytes) to use when precaching a file/URL.
-Especially useful on slow media (default is \-nocache).
+This option specifies how much memory (in kbytes) to use when precaching a
+file/URL. Especially useful on slow media (default is \-nocache).
 .TP
 .B \-cdda <option1:option2>
 This option can be used to tune the CD Audio reading feature of MPlayer.
 Available options are:
-
-    speed=<value>        set CD spin speed
-    paranoia=<value>     set paranoia level (0-2)
-                           0: disable checking
-                           1: overlap checking only
-                              (default)
-                           2: full data correction
-                              and verification
-    generic-dev=<value>  use specified generic SCSI
-                         device
-    sector-size=<value>  atomic read size
-    overlap=<value>      force minimum overlap
-                         search during verification
-                         to <value> sectors.
-    toc-bias             Assume that the beginning
-                         offset of track 1 as
-                         reported in the TOC will
-                         be addressed as LBA 0.
-                         Some Toshiba drives need
-                         this for getting track
-                         boundaries correct.
-    toc-offset=<value>   Add <value> sectors to the
-                         values reported when
-                         addressing tracks. May be
-                         negative.
-    (no)skip             (never) accept imperfect
-                         data reconstruction.
+.
+.RSs
+.IPs speed=<value>
+set CD spin speed
+.IPs paranoia=<0\-2>
+set paranoia level
+.RSss
+0: disable checking
+.br
+1: overlap checking only (default)
+.br
+2: full data correction and verification
+.REss
+.IPs generic-dev=<value>
+use specified generic SCSI device
+.IPs sector-size=<value>
+atomic read size
+.IPs overlap=<value>
+force minimum overlap search during verification to <value> sectors.
+.IPs toc-bias
+Assume that the beginning offset of track 1 as reported in the TOC will be
+addressed as LBA 0. Some Toshiba drives need this for getting track boundaries
+correct.
+.IPs toc-offset=<value>
+Add <value> sectors to the values reported when addressing tracks. May be
+negative.
+.IPs (no)skip
+(never) accept imperfect data reconstruction.
+.RE
+.
 .TP
 .B \-chapter <chapter\ id>[-<end\ chapter\ id>]
 Specify which chapter to start playing at. Optionally specify which chapter to
 end playing at (default: 1). Examples can be found below.
 .TP
 .B \-csslib <filename>
-(old-style DVD option) This option is used to override the default location of libcss.so.
+(old-style DVD option) This option is used to override the default location of
+libcss.so.
 .TP
 .B \-demuxer <number>
 Force demuxer type. Give the demuxer ID as defined in demuxers.h.
@@ -335,8 +367,9 @@ Dump raw compressed video stream to ./stream.dump (not very usable).
 .B \-dvd <title\ id>
 Tell MPlayer which movies (specified by title id) to play. For example
 sometimes '1' is a trailer, and '2' is the real movie.
-.br
+
 .I NOTE:
+.br
 Sometimes deinterlacing is required for DVD playback,
 see the \-pp 0x20000 or \-npp lb options.
 .TP
@@ -365,7 +398,8 @@ Seeking will be possible. You can fix the index permanently with
 MEncoder (see the documentation).
 .TP
 .B \-fps <value>
-Override video framerate (if value is wrong/missing in the header) (float number).
+Override video framerate (if value is wrong/missing in the header) (float
+number).
 .TP
 .B \-frames <number>
 Play/convert only first <number> frames, then quit.
@@ -385,15 +419,23 @@ downloads, or badly created AVIs.
 Maximum A-V sync correction per frame (in seconds).
 .TP
 .B \-mf <option1:option2:...>
-Used when decoding from multiple PNG or JPEG files
-(see documentation). Available options are:
+Used when decoding from multiple PNG or JPEG files. Available options are:
 
-    on            turns on multifile support
-    w=<value>     width of the output (autodetect)
-    h=<value>     height of the output (autodetect)
-    fps=<value>   fps of the output (default: 25)
-    type=<value>  type of input files
-                  (available types: jpeg, png)
+.PD 0
+.RSs
+.IPs on
+turns on multifile support
+.IPs w=<value>
+width of the output (autodetect)
+.IPs h=<value>
+height of the output (autodetect)
+.IPs fps=<value>
+fps of the output (default: 25)
+.IPs type=<value>
+type of input files (available types: jpeg, png)
+.RE
+.PD 1
+.
 .TP
 .B \-ni (.AVI only)
 Force usage of non\-interleaved AVI parser (fixes playing
@@ -411,11 +453,21 @@ This option lets you play raw audio files. It may also be used to
 play audio CDs which are not 44KHz 16Bit stereo.
 Available options are:
 
-    on                  use raw audio demuxer
-    channels=<value>    number of channels
-    rate=<value>        rate in samples per second
-    samplesize=<value>  sample size in byte
-    format=<value>      fourcc in hex
+.PD 0
+.RSs
+.IPs on
+use raw audio demuxer
+.IPs channels=<value>
+number of channels
+.IPs rate=<value>
+rate in samples per second
+.IPs samplesize=<value>
+sample size in byte
+.IPs format=<value>
+fourcc in hex
+.RE
+.PD 1
+.
 .TP
 .B \-skipopening
 Skip DVD opening (dvdnav only).
@@ -432,69 +484,21 @@ MEncoder passes this value to lame for resampling.
 Seek to given time position.
 
 .I EXAMPLE:
-    \-ss 56        seeks to 56 seconds
-    \-ss 01:10:00  seeks to 1 hour 10 min
+.PD 0
+.RSs
+.IPs "\-ss 56"
+seeks to 56 seconds
+.IPs "\-ss 01:10:00"
+seeks to 1 hour 10 min
+.RE
+.PD 1
+.
 .TP
 .B \-tv <option1:option2:...>
-This option enables the TV grabbing feature of MPlayer (see documentation).
-Available options are:
-
-    on                use TV input
-    noaudio           no sound
-    driver=<value>    available: dummy, v4l,
-                      bsdbt848
-    device=<value>    Specify other device than the
-                      default /dev/video0.
-    input=<value>     Specify other input than the
-                      default 0 (Television)
-                      (see output for a list)
-    freq=<value>      Specify the frequency to set
-                      the tuner to (e.g. 511.250).
-    outfmt=<value>    output format of the tuner
-                      (yv12, rgb32, rgb24, rgb16,
-                      rgb15, uyvy, yuy2, i420)
-    width=<value>     width of the output window
-    height=<value>    height of the output window
-    norm=<value>      available: PAL, SECAM, NTSC
-    channel=<value>   Set tuner to <value> channel.
-    chanlist=<value>  available: europe-east,
-                      europe-west, us-bcast,
-                      us-cable, etc
-    audiorate=<value> set audio capture bitrate
-    alsa              capture from ALSA
-    amode=<0..3>      choose an audio mode:
-                      0 .. mono
-                      1 .. stereo
-                      2 .. language 1
-                      3 .. language 2
-    forcechan=<1,2>   By default, the count of
-                      recorded audio channels is
-                      determined automatically
-                      by querying the audio mode
-                      from the tv card. This option
-                      allows to force stereo/mono
-                      recording regardless of the
-                      amode option and the values
-                      returned by v4l. This can
-                      be used for troubleshooting
-                      when the tv card is unable
-                      to report the current audio
-                      mode.
-    adevice=<value>   set an audio device
-                      /dev/... for OSS,
-                      hardware ID for ALSA
-    audioid=<value>   choose an audio output
-                      of the capture card, if it
-                      has more of them
-    volume=<value>    These options set
-    bass=<value>      parameters of the mixer
-    treble=<value>    on the video capture card.
-    balance=<value>   They will have no effect,
-                      if your card doesn't have
-                      one. All values are from
-                      0 to 65535.
+This option enables the TV grabbing feature of MPlayer.
 
 .I NOTE:
+.br
 Mplayer doesn't accept colons so type dots instead in the device ID,
 eg. hw.0,0 instead of hw:0,0)
 .br
@@ -502,6 +506,70 @@ Be advised that although you can select any samplerate when using ALSA,
 the LAME audio codec is able to encode only the "standard" samplerates.
 You'll get an .avi file with no sound when you choose an odd
 samplerate and use this codec.
+.br
+Available options are:
+.
+.RSs
+.IPs on
+use TV input
+.IPs noaudio
+no sound
+.IPs driver=<value>
+available: dummy, v4l, bsdbt848
+.IPs device=<value>
+Specify other device than the default /dev/video0.
+.IPs input=<value>
+Specify other input than the default 0 (Television) (see output for a list)
+.IPs freq=<value>
+Specify the frequency to set the tuner to (e.g. 511.250).
+.IPs outfmt=<value>
+output format of the tuner (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2,
+i420)
+.IPs width=<value>
+width of the output window
+.IPs height=<value>
+height of the output window
+.IPs norm=<value>
+available: PAL, SECAM, NTSC
+.IPs channel=<value>
+Set tuner to <value> channel.
+.IPs chanlist=<value>
+available: europe-east, europe-west, us-bcast, us-cable, etc
+.IPs audiorate=<value>
+set audio capture bitrate
+.IPs alsa
+capture from ALSA
+.IPs amode=<0\-3>
+choose an audio mode:
+.RSss
+0: mono
+.br
+1: stereo
+.br
+2: language 1
+.br
+3: language 2
+.REss
+.IPs forcechan=<1\-2>
+By default, the count of recorded audio channels is determined automatically
+by querying the audio mode from the tv card. This option allows to force
+stereo/mono recording regardless of the amode option and the values returned
+by v4l. This can be used for troubleshooting when the tv card is unable to
+report the current audio mode.
+.IPs adevice=<value>
+set an audio device
+.RSss
+/dev/... for OSS
+.br
+hardware ID for ALSA
+.REss
+.IPs audioid=<value>
+choose an audio output of the capture card, if it has more of them
+.IPs "[volume|bass|treble|balance]=<0\-65535>"
+These options set parameters of the mixer on the video capture card. They will
+have no effect, if your card doesn't have one.
+.RE
+.
 .TP
 .B \-user <user name> (see \-passwd option too!)
 Specify user name for http authentication.
@@ -510,7 +578,7 @@ Specify user name for http authentication.
 Play video CD track from device instead of plain file.
 .TP
 .B \-vid <id>
-Select video channel [MPG: 0\-15  ASF:  0\-255].
+Select video channel [MPG: 0\-15 ASF: 0\-255].
 .TP
 .B \-vivo <sub\-options> (DEBUG CODE)
 Force audio parameters for the .vivo demuxer (for debugging purposes).
@@ -518,6 +586,7 @@ Force audio parameters for the .vivo demuxer (for debugging purposes).
 
 .SH "OSD/SUB OPTIONS"
 .I NOTE:
+.br
 See \-vop expand too.
 .TP
 .B \-dumpmpsub (MPLAYER only)
@@ -536,25 +605,41 @@ subtitles.
 .B \-ffactor <number>
 Resample alphamap of the font. Can be:
 
-    0     plain white fonts
-    0.75  very narrow black outline [default]
-    1     narrow black outline
-    10    bold black outline
+.PD 0
+.RSs
+.IPs 0
+plain white fonts
+.IPs 0.75
+very narrow black outline [default]
+.IPs 1
+narrow black outline
+.IPs 10
+bold black outline
+.RE
+.PD 1
+.
 .TP
 .B \-font <path\ to\ font.desc\ file>
 Search for the OSD/SUB fonts in an alternative directory (default for normal
 fonts: ~/.mplayer/font/font.desc, default for FreeType fonts:
 ~/.mplayer/subfont.ttf).
-.br
+
 .I NOTE:
+.br
 With FreeType, this option determines path to the text font file.
 .br
 The \-subfont-* options are available only with FreeType support compiled in.
 If FreeType support is enabled, the old font support can't be used.
 
 .I EXAMPLE:
-    \-font ~/.mplayer/arial\-14/font.desc
-    \-font ~/.mplayer/arialuni.ttf
+.PD 0
+.RSs
+\-font ~/.mplayer/arial\-14/font.desc
+.br
+\-font ~/.mplayer/arialuni.ttf
+.RE
+.PD 1
+.
 .TP
 .B \-noautosub
 Turns off automatic subtitles.
@@ -563,7 +648,7 @@ Turns off automatic subtitles.
 Specifies which mode the OSD should start in (0: none, 1: seek, 2: seek+timer,
 default is 1).
 .TP
-.B \-sid <id> (also see -slang option)
+.B \-sid <id> (also see \-slang option)
 Turns on DVD subtitle displaying. Also, you MUST specify a number which
 corresponds to a DVD subtitle language (0\-31). For the list of available
 subtitles, use with the \-v switch and look at the output.
@@ -573,9 +658,13 @@ Works only for DVD playback! Turns on/selects DVD subtitle language. For the
 list of available subtitles, use with the \-v switch and look at the output.
 
 .I EXAMPLE:
-    \-slang hu,en  Selects Hungarian and falls back
-                  to English if Hungarian is not
-                  available.
+.PD 0
+.RSs
+.IPs "\-slang hu,en"
+Selects Hungarian and falls back to English if Hungarian is not available.
+.RE
+.PD 1
+.
 .TP
 .B \-sub <subtitle\ file>
 Use/display this subtitle file.
@@ -591,8 +680,14 @@ If your system supports iconv(3), you can use this option to
 specify codepage of the subtitle.
 
 .I EXAMPLE:
-    \-subcp  latin2
-    \-subcp  cp1250
+.PD 0
+.RSs
+\-subcp latin2
+.br
+\-subcp  cp1250
+.RE
+.PD 1
+.
 .TP
 .B \-sub\-demuxer <number> (BETA CODE)
 Force subtitle demuxer type for \-subfile.
@@ -601,15 +696,27 @@ Force subtitle demuxer type for \-subfile.
 Delays subtitles by <sec> seconds. Can be negative.
 .TP
 .B \-subfont-autoscale <0\-3>
-Sets the autoscale mode. Can be:
-
-    0  no autoscale
-    1  proportional to movie width
-    2  proportional to movie height
-    3  proportional to movie diagonal (default)
+Sets the autoscale mode.
 
 .I NOTE:
+.br
 Zero means that text-scale and osd-scale are font heights in points.
+.br
+The mode can be:
+
+.PD 0
+.RSs
+.IPs 0
+no autoscale
+.IPs 1
+proportional to movie width
+.IPs 2
+proportional to movie height
+.IPs 3
+proportional to movie diagonal (default)
+.RE
+.PD 1
+.
 .TP
 .B \-subfont-blur <0\-8>
 Sets the font blur radius (default: 2).
@@ -631,14 +738,15 @@ screen size) (default: 5).
 .B \-subfps <rate>
 Specify frame/sec rate of subtitle file (float number),
 default: the same fps as the movie.
-.br
+
 .I NOTE:
+.br
 ONLY for frame\-based SUB files, i.e. NOT MicroDVD format!
 .TP
 .B \-subfile <filename> (BETA CODE)
 Currently useless. Same as \-audiofile, but for subtitle streams (OggDS?).
 .TP
-.B \-subpos <0\-100> (useful with -vop expand)
+.B \-subpos <0\-100> (useful with \-vop expand)
 Specify the position of subtitles on the screen. The value is the vertical
 position of the subtitle in % of the screen height.
 .TP
@@ -660,55 +768,74 @@ Specify the VobSub subtitle id. Valid values range from 0 to 31.
 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
 .TP
 .B \-abs <value> (OBSOLETE)
-Override audio driver/card buffer size detection, -ao oss only
+Override audio driver/card buffer size detection, \-ao oss only
 .TP
 .B \-ao <driver>[:<device>]
 Select audio output driver and optionally device. "device" is valid with
 SDL, too, it means subdriver then.
-.br
+
 .I NOTE:
-You can get the list of available drivers executing
-.I mplayer \-ao help
+.br
+To get a full list of available drivers, see \-ao help.
 
 .I EXAMPLE
-    \-ao oss:/dev/dsp1  specifies the sound device
-                       to use with OSS (replaces
-                       the old \-dsp option)
-    \-ao sdl:esd        specifies the SDL subdriver
+.PD 0
+.RSs
+.IPs "\-ao oss:/dev/dsp1"
+specifies the sound device to use with OSS (replaces the old \-dsp option)
+.IPs "\-ao sdl:esd"
+specifies the SDL subdriver
+.RE
+.PD 1
+.
 .TP
 .B \-aofile <filename>
 Filename for \-ao pcm.
 .TP
 .B \-aop <plugin1:plugin2:...>
-Specify audio plugin(s) and their options (see documentation!!).
+Specify audio plugin(s) and their options (see documentation too).
 Available options are:
-
-    list=[plugins]   comma separated list of
-                     plugins (resample, surround,
-                     format, volume, extrastereo,
-                     volnorm)
-    delay=<sec>      example plugin, do not use!
-    format=<format>  output format
-                     (format plugin only)
-    fout=<Hz>        output frequency
-                     (resample plugin only)
-    volume=<0-255>   volume (volume plugin only)
-    mul=<value>      stereo coefficient, defaults
-                     to 2.5
-                     (extrastereo plugin only)
-    softclip         compressor/"soft\-clipping"
-                     capabilities
-                     (volume plugin only)
+.
+.RSs
+.IPs list=[plugins]
+comma separated list of plugins (resample, surround, format, volume,
+extrastereo, volnorm)
+.IPs delay=<sec>
+example plugin, do not use!
+.IPs format=<format>
+output format (format plugin only)
+.IPs fout=<Hz>
+output frequency (resample plugin only)
+.IPs volume=<0\-255>
+volume (volume plugin only)
+.IPs mul=<value>
+stereo coefficient (default: 2.5) (extrastereo plugin only)
+.IPs softclip
+compressor/"soft\-clipping" capabilities (volume plugin only)
+.RE
+.
 .TP
 .B \-channels <number>
-Select number of audio output channels to be used. Available options are:
-
-    Stereo    2
-    Surround  4
-    Full 5.1  6
+Select number of audio output channels to be used.
 
 .I NOTE:
-Currently this option is only honored for AC3 audio, and/or the surround plugin.
+.br
+Currently this option is only honored for AC3 audio, and/or the surround
+plugin.
+.br
+Available options are:
+
+.PD 0
+.RSs
+.IPs 2
+Stereo
+.IPs 4
+Surround
+.IPs 6
+Full 5.1
+.RE
+.PD 1
+.
 .TP
 .B \-delay <sec>
 Audio delay in seconds (may be +/\- float value).
@@ -736,14 +863,20 @@ Adjust brightness of video output (default 0). It changes intensity of
 RGB components of video signal from black to white screen.
 .TP
 .B \-contrast <\-100\ \-\ 100>
-Adjust contrast of video output (default 0). Works in similar manner as brightness.
+Adjust contrast of video output (default 0). Works in similar manner as
+brightness.
 .TP
 .B \-display <name>
-Specify the hostname and display number of the X server you want
-to display on.
+Specify the hostname and display number of the X server you want to display
+on.
 
 .I EXAMPLE:
-    \-display  xtest.localdomain:0
+.PD 0
+.RSs
+\-display xtest.localdomain:0
+.RE
+.PD 1
+.
 .TP
 .B \-double
 Enables doublebuffering. Fixes flicker by storing two frames in memory, and
@@ -756,30 +889,49 @@ Turns on direct rendering (not supported by all codecs and video outputs)
 .TP
 .B \-dxr2 <option1:option2:...>
 This option is used to control the dxr2 driver.
-
-    overlay                 enable the overlay
-    overlay-ratio           tune the overlay
-    ucode=<value>           path to the microcode
-    norm=<value>            TV norm
-    ar-mode=<value>         aspect ratio mode
-    macrovision=<value>     macrovision mode
-    75ire                   enable 7.5 IRE
-    bw                      b/w TV output
-    color                   color TV output
-    interlaced              interlaced TV output
-    square/ccir601-pixel    TV pixel mode
-    iec958-encoded/decoded  iec958 output mode
-    mute                    mute sound output
-    ignore-cache            do not use VGA cache
-    update-cache            recreate VGA cache
+.
+.RSs
+.IPs overlay
+enable the overlay
+.IPs overlay-ratio
+tune the overlay
+.IPs ucode=<value>
+path to the microcode
+.IPs norm=<value>
+TV norm
+.IPs ar-mode=<value>
+aspect ratio mode
+.IPs macrovision=<value>
+macrovision mode
+.IPs 75ire
+enable 7.5 IRE
+.IPs bw
+b/w TV output
+.IPs color
+color TV output
+.IPs interlaced
+interlaced TV output
+.IPs square/ccir601\-pixel
+TV pixel mode
+.IPs iec958\-encoded/decoded
+iec958 output mode
+.IPs mute
+mute sound output
+.IPs ignore\-cache
+do not use VGA cache
+.IPs update\-cache
+recreate VGA cache
+.RE
+.
 .TP
 .B \-fb <device> (fbdev or DirectFB only)
 Specifies the framebuffer device to use. By default it uses /dev/fb0.
 .TP
 .B \-fbmode <modename> (fbdev only)
 Change video mode to the one that is labelled as <modename> in /etc/fb.modes.
-.br
+
 .I NOTE:
+.br
 VESA framebuffer doesn't support mode changing.
 .TP
 .B \-fbmodeconfig <filename> (fbdev only)
@@ -794,7 +946,7 @@ Fullscreen playing (centers movie, and makes black
 bands around it). Toggle it with the 'f' key (not all video
 outputs support it).
 .TP
-.B \-fsmode-dontuse <0-31> (OBSOLETE) (use -fs option)
+.B \-fsmode-dontuse <0-31> (OBSOLETE) (use \-fs option)
 Try this option if you still experience fullscreen problems.
 .TP
 .B \-hue <\-100\ \-\ 100>
@@ -804,32 +956,49 @@ of image with this option.
 .B \-icelayer <0\-15> (icewm only)
 Sets the layer of the fullscreen window of mplayer for icewm.
 
-    Desktop     0
-    Below       2
-    Normal      4
-    OnTop       6
-    Dock        8
-    AboveDock  10
-    Menu       12 (default)
+.PD 0
+.RSs
+.IPs 0
+Desktop
+.IPs 2
+Below
+.IPs 4
+Normal
+.IPs 6
+OnTop
+.IPs 8
+Dock
+.IPs 10
+AboveDock
+.IPs 12
+Menu (default)
+.RE
+.PD 1
+.
 .TP
 .B \-jpeg <option1:option2:...> (\-vo jpeg only)
-Specify options for the JPEG output (see documentation).
-Available options are [no]progressiv, [no]baseline,
-optimize, smooth, quality and outdir.
+Specify options for the JPEG output. Available options are:
+[no]progressiv, [no]baseline, optimize, smooth, quality and outdir.
 .TP
-.B \-monitor_dotclock <dotclock\ (or\ pixelclock) range>  (fbdev only)
+.B \-monitor_dotclock <dotclock\ (or\ pixelclock) range> (fbdev only)
 Look into etc/example.conf for further information and in DOCS/video.html.
 .TP
-.B \-monitor_hfreq <horizontal frequency range>  (fbdev only)
+.B \-monitor_hfreq <horizontal frequency range> (fbdev only)
 .TP
-.B \-monitor_vfreq <vertical frequency range>  (fbdev only)
+.B \-monitor_vfreq <vertical frequency range> (fbdev only)
 .TP
 .B \-monitoraspect <ratio>
 Set aspect ratio of your screen.
 
 .I EXAMPLE:
-    \-monitoraspect 4:3  or 1.3333
-    \-monitoraspect 16:9 or 1.7777
+.PD 0
+.RSs
+\-monitoraspect 4:3  or 1.3333
+.br
+\-monitoraspect 16:9 or 1.7777
+.RE
+.PD 1
+.
 .TP
 .B \-noslices
 Disable drawing video by 16-pixel height slices/bands, instead draws the
@@ -854,8 +1023,8 @@ a new one. Works only with x11, xv, xmga and xvidix drivers.
 .TP
 .B \-screenw <pixels> \-screenh <pixels>
 If you use an output driver which can't know the resolution of the screen
-(fbdev/x11 and/or TVout) this is where you can specify the horizontal and vertical
-resolution.
+(fbdev/x11 and/or TVout) this is where you can specify the horizontal and
+vertical resolution.
 .TP
 .B \-vm \ \ \ 
 Try to change to a better video mode. dga, x11/xv (XF86VidMode) and sdl
@@ -864,13 +1033,20 @@ output drivers support it.
 .B \-vo <driver>[:<device>]
 Select video output driver and optionally device. "device" is valid with
 SDL and GGI too, it means subdriver then.
-.br
+
 .I NOTE:
+.br
 See \-vo help for a full list of available drivers.
 
 .I EXAMPLE:
-    \-vo xmga
-    \-vo sdl:aalib
+.PD 0
+.RSs
+\-vo xmga
+.br
+\-vo sdl:aalib
+.RE
+.PD 1
+.
 .TP
 .B \-vsync \ \ 
 Enables VBI for vesa.
@@ -881,12 +1057,21 @@ browser (with the plugger extension for instance).
 .TP
 .B \-xineramascreen <screen\ number>
 In Xinerama configurations (i.e. a single desktop that spans across multiple
-displays) this option tells MPlayer which screen to display movie on. Range 0 \- ...
+displays) this option tells MPlayer which screen to display movie on. Range 0
+\- ...
 .TP
 .B \-z <0\-9>
 Specifies compression level for PNG output (-vo png)
-    0  no compression
-    9  max compression
+
+.PD 0<