rewrite (again ;), cosmetics, no real changes

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

1 files changed, 650 insertions, 551 deletions

diff --git a/DOCS/mplayer.1 b/DOCS/mplayer.1
index f3d5d6d3a4..8d53fccf0c 100644
--- a/DOCS/mplayer.1
+++ b/DOCS/mplayer.1
@@ -1,9 +1,10 @@
 .\" MPlayer (C) 2000-2002 Arpad Gereoffy
 .\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann
 .\" 
-.\" Run groff -m man -Thtml mplayer.1 > manpage.html for a html version
-.\" Run groff -m man -Tascii mplayer.1 | col -bx > manpage.txt for a text
-.\"   version
+.\" Run this to get a html version of the man page:
+.\"   cat mplayer.1 | sed s/SS\ 20/SS\ 4/ | groff -man -Thtml - > manpage.html
+.\" Run this to get a text version of the man page:
+.\"   groff -m man -Tascii mplayer.1 | col -bx > manpage.txt
 .\" 
 .
 .\" --------------------------------------------------------------------------
@@ -12,10 +13,8 @@
 .
 .\" default indentation is 7, don't change!
 .nr IN 7
-..
 .\" define indentation for suboptions
 .nr SS 20
-..
 .\" add new suboption
 .de IPs
 .IP "\\$1" \n(SS
@@ -51,29 +50,47 @@ mencoder \- Movie Encoder for Linux
 .\" --------------------------------------------------------------------------
 .
 .SH SYNOPSIS
+.na
+.nh
 .B mplayer
 .RI [options]\ [ \ file\  | \ URL\  | \ playlist\  | \ -\  ]
 .br
 .B mplayer
-.RI [global\ options] \ file1\  [specific\ options]\ [file2]\ \
-[specific\ options]
+'in +\n[.k]u
+[global options]
+.I file1
+[specific options] [file2] [specific options]
 .br
+.in
 .B mplayer
-.RI [global\ options]\ { group\ of\ files\ and\ options }\ \
-[group\ specific\ options]
+'in +\n[.k]u
+[global options]
+.RI { "group of files and options" }
+[group specific options]
 .br
+.in
 .B mplayer
-.RI [ dvd | vcd | cdda | cddb | tv ] ://title\  [options]
+'in +\n[.k]u
+.RI [ dvd | vcd | cdda | cddb | tv ] ://title
+[options]
 .br
+.in
 .B mplayer
-.RI [ mms[t] | http | http_proxy | rt[s]p | smb ] :// [user:passwd@] URL [:port]\ \
-[options]
+'in +\n[.k]u
+.RI [ mms[t] | http | http_proxy | rt[s]p | smb ] :// [user:passwd@] URL
+[:port] [options]
 .br
+.in
 .B mencoder
-.RI [options]\ [ \ file\  | \ URL\  | \ -\  ]\ [\-o\ file]
+[options]
+.RI [ \ file\  | \ URL\  | \ -\  ]
+[\-o\ file]
 .br
 .B gmplayer
-.RI [options]\ [\-skin\ skin]
+[options]
+[\-skin\ skin]
+.ad
+.hy
 
 .\" --------------------------------------------------------------------------
 .\" Description
@@ -81,37 +98,40 @@ 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, ASF/WMA/WMV, RM,
-QT/MOV/MP4, OGG/OGM, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and 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).
+is a movie player for LINUX (runs on many other Unices and non\-x86 CPUs, see
+the documentation).
+It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, OGG/\:OGM,
+VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and 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 also use GGI, SDL (and this way all their drivers), VESA (on every
-VESA compatible card, even without X11!), some low level card-specific drivers
-(for Matrox, 3Dfx and ATI) and some hardware MPEG decoder boards, such as the
-Siemens DVB, DXR2 and DXR3/Hollywood+.
-.br
+drivers.
+It works with X11, XV, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you
+can also use GGI, SDL (and this way all their drivers), VESA (on every VESA
+compatible card, even without X11), some low level card-specific drivers (for
+Matrox, 3Dfx and ATI) and some hardware MPEG decoder boards, such as the
+Siemens DVB, DXR2 and DXR3/\:Hollywood+.
 Most of them support software or hardware scaling, so you can enjoy movies in
 fullscreen.
 .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
+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) and DVD
 subtitles (SPU streams, VobSub and Closed Captions).
 .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, XviD, one of the libavcodec codecs and
-PCM/MP3/VBRMP3 audio in 1, 2 or 3 passes. Furthermore it has stream copying
-abilities, a powerful plugin system (crop, expand, flip, postprocess, rotate,
-scale, noise, rgb/yuv conversion) and more.
+(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, XviD, one of the libavcodec codecs and PCM/\:MP3/\:VBRMP3
+audio in 1, 2 or 3\ passes.
+Furthermore it has stream copying abilities, a powerful plugin system (crop,
+expand, flip, postprocess, rotate, scale, noise, rgb/\:yuv conversion) and
+more.
 .PP
 .B gmplayer
 is MPlayer with a graphical user interface.
@@ -122,78 +142,81 @@ It has the same options as MPlayer.
 .\" Options
 .\" --------------------------------------------------------------------------
 .
-.SH GENERAL NOTES
+.SH "GENERAL NOTES"
 .B Also see the HTML documentation!
-
-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'.
+.PP
+Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
+\-fs option is \-nofs.
+.PP
+You can put all of the options in a configuration file which will be read
+every time mplayer is run.
+The system-wide configuration 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 configuration 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.
 
+.nf
 .I EXAMPLE:
-.br
 # Use Matrox driver by default.
-.br
 vo=xmga
-.br
 # I love practicing handstands while watching videos.
-.br
 flip=yes
-.br
-# Decode/encode multiple files from png, start it with -mf on
-.br
+# Decode/\:encode multiple files from png, start it with -mf on
 mf= type=png:fps=25
+.fi
 
 
 .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 postprocessing depending on available spare
-CPU time. 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.
+CPU time.
+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.
 .TP
 .B \-autosync <factor>
-Gradually adjusts the A/V sync based on audio delay measurements.
-Specifying \-autosync 0, the default, will cause frame timing to be based
-entirely on audio delay measurements.  Specifying \-autosync 1 will do the
-same, but will subtly change the A/V correction algorithm used.  An uneven
-video frame rate in a movie which plays fine with -nosound can often be
-helped by setting this to an integer value greater than 1.  The higher
-the value, the closer the timing will be to -nosound.
-
-Try \-autosync 30 to smooth out problems with sound drivers which do
-not implement a perfect audio delay measurement.  With this value, if
-large A/V sync offsets occur, they will only take about 1 or 2 seconds
-to settle out.  This delay in reaction time to sudden A/V offsets should
-be the only side-effect of turning this option on, for all sound drivers.
+Gradually adjusts the A/\:V sync based on audio delay measurements.
+Specifying \-autosync\ 0, the default, will cause frame timing to be based
+entirely on audio delay measurements.
+Specifying \-autosync\ 1 will do the same, but will subtly change the A/\:V
+correction algorithm used.
+An uneven video frame rate in a movie which plays fine with \-nosound can
+often be helped by setting this to an integer value greater than 1.
+The higher the value, the closer the timing will be to -nosound.
+.PP
+Try \-autosync\ 30 to smooth out problems with sound drivers which do
+not implement a perfect audio delay measurement.
+With this value, if large A/\:V sync offsets occur, they will only take about
+1 or 2\ seconds to settle out.
+This delay in reaction time to sudden A/\:V offsets should be the only
+side-effect of turning this option on, for all sound drivers.
 .TP
 .B \-benchmark
 Prints some statistics on CPU usage and dropped frames at the end.
-Use in combination with \-nosound and \-vo null for benchmarking only the video
-codec.
+Use in combination with \-nosound and \-vo null for benchmarking only the
+video codec.
 .TP
 .B \-framedrop (also see \-hardframedrop)
-Skips displaying some frames to maintain A/V sync on slow systems. Decoding of
-B frames is also skipped and video filters are not used.
+Skips displaying some frames to maintain A/\:V sync on slow systems.
+Decoding of B frames is also skipped and video filters are not used.
 .TP
 .B \-h, \-help, \-\-help
 Show short summary of options.
 .TP
 .B \-hardframedrop
-More intense frame dropping (breaks decoding). Leads to image distortion!
+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.
-Paths are relative to $HOME/.mplayer/.
+Paths are relative to ~/\:.mplayer/.
 
 .I NOTE:
 .br
@@ -204,8 +227,8 @@ Available commands are:
 .PD 0
 .RSs
 .IPs conf=<file>
-Read alternative input.conf. If given without pathname, $HOME/.mplayer is
-assumed.
+Read alternative input.conf.
+If given without pathname, ~/\:.mplayer is assumed.
 .IPs ar\-delay
 Delay in msec before we start to autorepeat a key (0 to disable).
 .IPs ar\-rate
@@ -215,26 +238,28 @@ Prints all keys that can be bound.
 .IPs cmdlist
 Prints all commands that can be bound.
 .IPs js\-dev
-Specifies the joystick device to use (default is /dev/input/js0).
+Specifies the joystick device to use (default is /dev/\:input/\:js0).
 .RE
 .PD 1
 .
 .TP
-.B \-lircconf <config\ file>
-Specifies a config file for LIRC (Linux Infrared Remote Control, see
-http://www.lirc.org) if you don't like the default ~/.lircrc.
+.B \-lircconf <configuration\ file>
+Specifies a configuration file for LIRC (Linux Infrared Remote Control, 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.
+Loops movie playback <number> times.
+0 means forever.
 .TP
 .B \-nojoystick
-Turns off joystick support. Default is on, if compiled in.
+Turns off joystick support.
+Default is on, if compiled in.
 .TP
 .B \-nolirc
 Turns off LIRC support.
 .TP
 .B \-nortc \ \ 
-Turns off usage of the Linux RTC (real-time clock \- /dev/rtc) as timing
+Turns off usage of the Linux RTC (real-time clock \- /dev/\:rtc) as timing
 mechanism.
 .TP
 .B \-playlist <file>
@@ -250,33 +275,32 @@ Load skin from the given directory (WITHOUT path name).
 .PD 0
 .RSs
 .IPs "\-skin fittyfene"
-tries these:
-.RSss
-/usr/local/share/mplayer/Skin/fittyfene
-.br
-~/.mplayer/Skin/fittyfene
-.REss
+tries /usr/\:local/\:share/\:mplayer/\:Skin/\:fittyfene first and
+~/.mplayer/\:Skin/\:fittyfene afterwards
 .RE
 .PD 1
 .
 .TP
 .B \-slave \ \ 
-This option switches on slave mode. This is intended for use
-of MPlayer as a backend to other programs. Instead of intercepting keyboard
-events, MPlayer will read simplistic command lines from its stdin.
+This option switches on slave mode.
+This is intended for use of MPlayer as a backend to other programs.
+Instead of intercepting keyboard events, MPlayer will read simplistic command
+lines from its stdin.
 The section
 .B SLAVE MODE PROTOCOL
 explains the syntax.
 .TP
 .B \-softsleep
-Uses high quality software timers. As precise as the RTC without requiring
-special privileges. Comes at the price of higher CPU consumption.
+Uses high quality software timers.
+As precise as the RTC without requiring special privileges.
+Comes at the price of higher CPU consumption.
 .TP
 .B \-speed <0.01\-100>
 Set playback speed rate.
 .TP
 .B \-sstep <sec>
-Specifies seconds between displayed frames. Useful for slideshows.
+Specifies seconds between displayed frames.
+Useful for slideshows.
 .TP
 .B \-use-stdin
 
@@ -284,14 +308,16 @@ Specifies seconds between displayed frames. Useful for slideshows.
 .SH "DEMUXER/STREAM OPTIONS"
 .TP
 .B \-aid <id> (also see \-alang option)
-Select audio channel [MPEG: 0\-31 AVI/OGM: 1\-99 ASF/RM: 0\-127
+Select audio channel [MPEG: 0\-31 AVI/\:OGM: 1\-99 ASF/\:RM: 0\-127
 VOB(AC3): 128\-159 VOB(LPCM): 160\-191]
 MPlayer prints the available IDs when running in verbose (-v) mode.
 .TP
 .B \-alang <two letter\ country\ code> (also see \-aid option)
-Works only for DVD playback! Selects DVD audio language. It always tries
-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.
+Works only for DVD playback.
+It selects the DVD audio language and always tries 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:
 .PD 0
@@ -311,14 +337,16 @@ Use \-audio\-demuxer 17 to force .mp3 detection.
 Play audio from an external file (WAV, MP3 or Ogg Vorbis).
 .TP
 .B \-cdrom\-device <path\ to\ device>
-Override default CDROM drive name /dev/cdrom.
+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).
+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.
+.br
 Available options are:
 .
 .RSs
@@ -327,11 +355,11 @@ set CD spin speed
 .IPs paranoia=<0\-2>
 set paranoia level
 .RSss
+.nf
 0: disable checking
-.br
 1: overlap checking only (default)
-.br
 2: full data correction and verification
+.fi
 .REss
 .IPs generic-dev=<value>
 use specified generic SCSI device
@@ -341,11 +369,11 @@ atomic read size
 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.
+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.
+Add <value> sectors to the values reported when addressing tracks.
+May be negative.
 .IPs (no)skip
 (never) accept imperfect data reconstruction.
 .RE
@@ -374,47 +402,49 @@ Full 5.1
 .
 .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.
+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.
 .TP
 .B \-demuxer <number>
-Force demuxer type. Give the demuxer ID as defined in demuxers.h.
+Force demuxer type.
+Give the demuxer ID as defined in demuxers.h.
 Use \-demuxer 17 to force .mp3 detection.
 .TP
 .B \-dumpaudio (MPLAYER only)
-Dumps raw compressed audio stream to ./stream.dump (useful with mpeg/ac3).
+Dumps raw compressed audio stream to ./\:stream.dump (useful with mpeg/\:ac3).
 .TP
 .B \-dumpfile <filename> (MPLAYER only)
-Specify which file MPlayer should dump to. Should be used together
-with \-dumpaudio/\-dumpvideo/\-dumpstream.
+Specify which file MPlayer should dump to.
+Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
 .TP
 .B \-dumpstream (MPLAYER only)
-Dumps the raw stream to ./stream.dump. Useful when ripping from
-DVD or network.
+Dumps the raw stream to ./\:stream.dump.
+Useful when ripping from DVD or network.
 .TP
 .B \-dumpvideo (MPLAYER only)
-Dump raw compressed video stream to ./stream.dump (not very usable).
+Dump raw compressed video stream to ./\:stream.dump (not very usable).
 .TP
 .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.
+Tell MPlayer which movies (specified by title id) to play.
+For example sometimes '1' is a trailer, and '2' is the real movie.
 
 .I NOTE:
 .br
 Sometimes deinterlacing is required for DVD playback,
-see the \-pp 0x20000 or \-npp lb options.
+see the \-pp 0x20000 or \-npp\ lb options.
 .TP
 .B \-dvd\-device <path\ to\ device>
-Override default DVD device name /dev/dvd.
+Override default DVD device name /dev/\:dvd.
 .TP
 .B \-dvdangle <angle\ id>
 Some DVD discs contain scenes that can be viewed from multiple angles.
-Here you can tell MPlayer which angles to use (default: 1). Examples can be
-found below.
+Here you can tell MPlayer which angles to use (default: 1).
+Examples can be found below.
 .TP
 .B \-dvdauth <DVD\ device>
 (old-style DVD option) Turns on DVD authentication using the given device.
@@ -428,37 +458,41 @@ when authenticating with the DVD drive using \-dvdauth).
 Force usage of libdvdnav.
 .TP
 .B \-forceidx
-Force rebuilding of INDEX. Useful for files with broken index (desyncs, etc).
-Seeking will be possible. You can fix the index permanently with
-MEncoder (see the documentation).
+Force rebuilding of INDEX.
+Useful for files with broken index (desyncs, etc).
+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
+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.
+Play/\:convert only first <number> frames, then quit.
 .TP
 .B \-hr\-mp3\-seek (.MP3 only)
-Hi\-res mp3 seeking. Default is: enabled when playing from external MP3 file,
-as we need to seek to the very exact position to keep A/V sync. It can be slow
-especially when seeking backwards \- it has to rewind to the beginning to find
-the exact frame.
+Hi\-res mp3 seeking.
+Default is: enabled when playing from external MP3 file, as we need to seek
+to the very exact position to keep A/\:V sync.It can be slow especially when
+seeking backwards \- it has to rewind to the beginning to find the exact
+frame.
 .TP
 .B \-idx (also see \-forceidx)
 Rebuilds INDEX of the AVI if no INDEX was found,
-thus allowing seeking. Useful with broken/incomplete
-downloads, or badly created AVIs.
+thus allowing seeking.
+Useful with broken/\:incomplete downloads, or badly created AVIs.
 .TP
 .B \-mc <seconds/frame>
 Maximum A-V sync correction per frame (in seconds).
 .TP
 .B \-mf <option1:option2:...>
-Used when decoding from multiple PNG or JPEG files. Available options are:
+Used when decoding from multiple PNG or JPEG files.
+.br
+Available options are:
 
 .PD 0
 .RSs
-.IPs on
+.IPs on\ \ \ 
 turns on multifile support
 .IPs w=<value>
 width of the output (autodetect)
@@ -477,20 +511,21 @@ Force usage of non\-interleaved AVI parser (fixes playing
 of some bad AVI files).
 .TP
 .B \-nobps (.AVI only)
-Do not use average byte/sec value for A\-V sync (AVI).
+Do not use average byte/\:sec value for A\-V sync (AVI).
 Helps with some AVI files with broken header.
 .TP
-.B \-passwd <password> (see \-user option too!)
+.B \-passwd <password> (see \-user option too)
 Specify password for http authentication.
 .TP
 .B \-rawaudio <option1:option2:...>
-This option lets you play raw audio files. It may also be used to
-play audio CDs which are not 44KHz 16Bit stereo.
+This option lets you play raw audio files.
+It may also be used to play audio CDs which are not 44KHz 16Bit stereo.
+.br
 Available options are:
 
 .PD 0
 .RSs
-.IPs on
+.IPs on\ \ \ 
 use raw audio demuxer
 .IPs channels=<value>
 number of channels
@@ -507,15 +542,15 @@ fourcc in hex
 .B \-skipopening
 Skip DVD opening (dvdnav only).
 .TP
-.B \-sb <byte\ position> (see \-ss option too!)
-Seek to byte position. Useful for playback from CDROM
-images / vob files with junk at the beginning.
+.B \-sb <byte\ position> (see \-ss option too)
+Seek to byte position.
+Useful for playback from CDROM images / .VOB files with junk at the beginning.
 .TP
 .B \-srate <Hz>
 Forces the given audio playback rate, changing video speed to keep a-v sync.
 MEncoder passes this value to lame for resampling.
 .TP
-.B \-ss <time> (see \-sb option too!)
+.B \-ss <time> (see \-sb option too)
 Seek to given time position.
 
 .I EXAMPLE:
@@ -524,7 +559,7 @@ Seek to given time position.
 .IPs "\-ss 56"
 seeks to 56 seconds
 .IPs "\-ss 01:10:00"
-seeks to 1 hour 10 min
+seeks to 1\ hour 10\ min
 .RE
 .PD 1
 .
@@ -534,29 +569,29 @@ 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)
+Mplayer doesn't accept colons so type dots instead in the device ID
+(e.g.\& hw.0,0 instead of hw:0,0).
 .br
 Be advised that although you can select any samplerate when using ALSA,
-the LAME audio codec is able to encode only the "standard" samplerates.
+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
+.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.
+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).
+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)
@@ -577,36 +612,36 @@ capture from ALSA
 .IPs amode=<0\-3>
 choose an audio mode:
 .RSss
+.nf
 0: mono
-.br
 1: stereo
-.br
 2: language 1
-.br
 3: language 2
+.fi
 .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.
+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
+/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.
+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!)
+.B \-user <user name> (see \-passwd option too)
 Specify user name for http authentication.
 .TP
 .B \-vcd <track>
@@ -626,12 +661,13 @@ See \-vop expand too.
 .TP
 .B \-dumpmpsub (MPLAYER only)
 Convert the given subtitle (specified with the \-sub switch) to MPlayer's
-subtitle format, MPsub. Creates a dump.mpsub file in the current directory.
+subtitle format, MPsub.
+Creates a dump.mpsub file in the current directory.
 .TP
 .B \-dumpsrtsub (MPLAYER only)
 Convert the given subtitle (specified with the \-sub switch) to the time-based
-SubViewer (SRT) subtitle format. Creates a dumpsub.srt file in current
-directory.
+SubViewer (SRT) subtitle format.
+Creates a dumpsub.srt file in the current directory.
 .TP
 .B \-dumpsub (MPLAYER only) (BETA CODE)
 Dumps the subtitle substream from VOB streams.
@@ -639,33 +675,35 @@ See -dump*sub and -vobsubout* options too.
 .TP
 .B \-dumpmicrodvdsub (MPLAYER only)
 Convert the given subtitle (specified with the \-sub switch) to the
-MicroDVD subtitle format. Creates a dumpsub.sub file in current directory.
+MicroDVD subtitle format.
+Creates a dumpsub.sub file in the current directory.
 .TP
 .B \-ifo <vobsub\ ifo\ file>
 Indicate the file that will be used to load palette and frame size for VOBSUB
 subtitles.
 .TP
 .B \-ffactor <number>
-Resample alphamap of the font. Can be:
+Resample alphamap of the font.
+Can be:
 
 .PD 0
 .RSs
-.IPs 0
+.IPs 0\ \ \ \ 
 plain white fonts
-.IPs 0.75
+.IPs 0.75\ \ 
 very narrow black outline [default]
-.IPs 1
+.IPs 1\ \ \ \ 
 narrow black outline
-.IPs 10
+.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).
+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).
 
 .I NOTE:
 .br
@@ -677,9 +715,9 @@ If FreeType support is enabled, the old font support can't be used.
 .I EXAMPLE:
 .PD 0
 .RSs
-\-font ~/.mplayer/arial\-14/font.desc
+\-font ~/\:.mplayer/\:arial\-14/\:font.desc
 .br
-\-font ~/.mplayer/arialuni.ttf
+\-font ~/\:.mplayer/\:arialuni.ttf
 .RE
 .PD 1
 .
@@ -692,13 +730,17 @@ 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)
-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.
+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.
 .TP
 .B \-slang <two\ letter\ country\ code> (also see \-sid option)
-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.
+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:
 .PD 0
@@ -710,13 +752,13 @@ Selects Hungarian and falls back to English if Hungarian is not available.
 .
 .TP
 .B \-sub <subtitle\ file>
-Use/display this subtitle file.
+Use/\:display this subtitle file.
 .TP
 .B \-subcc \ 
-Display DVD Closed Caption (CC) subtitles. These are NOT the VOB subtitles,
-these are special ASCII subtitles for the hearing impaired encoded in the VOB
-userdata stream on most region 1 DVDs. CC subtitles have not been spotted on
-DVDs from other regions so far.
+Display DVD Closed Caption (CC) subtitles.
+These are NOT the VOB subtitles, these are special ASCII subtitles for the
+hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.
+CC subtitles have not been spotted on DVDs from other regions so far.
 .TP
 .B \-subcp <codepage>
 If your system supports iconv(3), you can use this option to
@@ -727,7 +769,7 @@ specify codepage of the subtitle.
 .RSs
 \-subcp latin2
 .br
-\-subcp  cp1250
+\-subcp cp1250
 .RE
 .PD 1
 .
@@ -736,7 +778,8 @@ specify codepage of the subtitle.
 Force subtitle demuxer type for \-subfile.
 .TP
 .B \-subdelay <sec>
-Delays subtitles by <sec> seconds. Can be negative.
+Delays subtitles by <sec> seconds.
+Can be negative.
 .TP
 .B \-subfont-autoscale <0\-3>
 Sets the autoscale mode.
@@ -765,8 +808,9 @@ proportional to movie diagonal (default)
 Sets the font blur radius (default: 2).
 .TP
 .B \-subfont-encoding <value>
-Sets the font encoding. When set to "unicode", all the glyphs from the
-font file will be rendered and unicode will be used (default: unicode).
+Sets the font encoding.
+When set to 'unicode', all the glyphs from the font file will be rendered and
+unicode will be used (default: unicode).
 .TP
 .B \-subfont-osd-scale <0\-100>
 Sets the osd elements autoscale coefficient (default: 6).
@@ -779,19 +823,20 @@ Sets the subtitle text autoscale coefficient (percentage of the
 screen size) (default: 5).
 .TP
 .B \-subfps <rate>
-Specify frame/sec rate of subtitle file (float number),
+Specify frame/\:sec rate of subtitle file (float number),
 default: the same fps as the movie.
 
 .I NOTE:
 .br
-ONLY for frame\-based SUB files, i.e. NOT MicroDVD format!
+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?).
+Currently useless.
+Same as \-audiofile, but for subtitle streams (OggDS?).
 .TP
 .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.
+Specify the position of subtitles on the screen.
+The value is the vertical position of the subtitle in % of the screen height.
 .TP
 .B \-unicode
 Tells MPlayer to handle the subtitle file as UNICODE.
@@ -800,22 +845,23 @@ Tells MPlayer to handle the subtitle file as UNICODE.
 Tells MPlayer to handle the subtitle file as UTF8.
 .TP
 .B \-vobsub <vobsub\ file\ without\ extension>
-Specify the VobSub files that are to be used for subtitle. This is
-the full pathname without extensions, i.e. without the ".idx", ".ifo"
-or ".sub".
+Specify the VobSub files that are to be used for subtitle.
+This is the full pathname without extensions, i.e.\& without the '.idx',
+\'.ifo' or '.sub'.
 .TP
 .B \-vobsubid <0-31>
-Specify the VobSub subtitle id. Valid values range from 0 to 31.
+Specify the VobSub subtitle id.
 
 
 .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 <driver1[:device],driver2,...[,]>
 Specify a priority list of audio output drivers (optionally with device) to be
-used. "device" is valid with SDL, too, it means subdriver then.
+used.
+\'device' is valid with SDL, too, it means subdriver then.
 
 .I NOTE:
 .br
@@ -826,7 +872,7 @@ If the list has a trailing ',' it will fallback to drivers not listed.
 .I EXAMPLE
 .PD 0
 .RSs
-.IPs "\-ao oss:/dev/dsp2,oss:/dev/dsp1,"
+.IPs "\-ao oss:/\:dev/\:dsp2,oss:/\:dev/\:dsp1,"
 try to use OSS with the specified sound devices and fallback to others if it
 fails
 .IPs "\-ao sdl:esd"
@@ -840,6 +886,7 @@ Filename for \-ao pcm.
 .TP
 .B \-aop <list=plugin1,plugin2...:option1=value1:opt2=val2...>
 Specify audio plugin(s) and their options (see documentation too).
+.br
 Available options are:
 .
 .RSs
@@ -847,7 +894,7 @@ Available options are:
 comma separated list of plugins (resample, surround, format, volume,
 extrastereo, volnorm)
 .IPs delay=<sec>
-example plugin, do not use!
+example plugin, do not use.
 .IPs format=<format>
 output format (format plugin only)
 .IPs fout=<Hz>
@@ -857,19 +904,20 @@ volume (volume plugin only)
 .IPs mul=<value>
 stereo coefficient (default: 2.5) (extrastereo plugin only)
 .IPs softclip
-compressor/"soft\-clipping" capabilities (volume plugin only)
+compressor/\:'soft\-clipping' capabilities (volume plugin only)
 .RE
 .
 .TP
 .B \-delay <sec>
-Audio delay in seconds (may be +/\- float value).
+Audio delay in seconds (may be +/\:\- float value).
 .TP
 .B \-mixer <device>
 This option will tell MPlayer to use a different device for mixing than
-/dev/mixer.
+/dev/\:mixer.
 .TP
 .B \-nowaveheader (-ao pcm only)
-Don't include wave header. Used for RAW PCM.
+Don't include wave header.
+Used for RAW PCM.
 
 
 .SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
@@ -879,16 +927,17 @@ You can get a list and an explanation of available options executing
 .I mplayer \-aahelp
 .TP
 .B \-bpp <depth>
-Use different color depth than autodetect. Not all \-vo drivers support
-it (fbdev, dga2, svga, vesa).
+Use different color depth than autodetect.
+Not all \-vo drivers support it (fbdev, dga2, svga, vesa).
 .TP
 .B \-brightness <\-100\ \-\ 100>
-Adjust brightness of video output (default 0). It changes intensity of
-RGB components of video signal from black to white screen.
+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
@@ -903,13 +952,17 @@ on.