Consistently insert lines with only "." between options.

Greatly improves readability.


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

1 files changed, 585 insertions, 19 deletions

diff --git a/DOCS/man/en/mplayer.1 b/DOCS/man/en/mplayer.1
index 9713a80420..8cb1dd38e2 100644
--- a/DOCS/man/en/mplayer.1
+++ b/DOCS/man/en/mplayer.1
@@ -49,12 +49,14 @@ mencoder \- movie encoder
 .nh
 .B mplayer
 .RI [options]\ [ \ file\  | \ URL\  | \ playlist\  | \ \-\  ]
+.
 .br
 .B mplayer
 'in +\n[.k]u
 [global options]
 .I file1
 [specific options] [file2] [specific options]
+.
 .br
 .in
 .B mplayer
@@ -62,70 +64,82 @@ mencoder \- movie encoder
 [global options]
 .RI { "group of files and options" }
 [group specific options]
+.
 .br
 .in
 .B mplayer
 'in +\n[.k]u
 .I dvd://[title | [start_title]\-end_title ]
 [options]
+.
 .br
 .in
 .B mplayer
 'in +\n[.k]u
 .I vcd://track[/device]
+.
 .br
 .in
 .B mplayer
 'in +\n[.k]u
 .I tv://[channel]
 [options]
+.
 .br
 .in
 .B mplayer
 'in +\n[.k]u
 .I dvb://[card_number@]channel
 [options]
+.
 .br
 .in
 .B mplayer
 'in +\n[.k]u
 .I mf://filemask
 [-mf options] [options]
+.
 .br
 .in
 .B mplayer
 'in +\n[.k]u
 .I [cdda|cddb]://track[:speed][/device]
 [options]
+.
 .br
 .in
 .B mplayer
 'in +\n[.k]u
 .I cue://file[:track]
 [options]
+.
 .br
 .in
 .B mplayer
 'in +\n[.k]u
 .RI [ mms[t] | http | http_proxy | rt[s]p | ftp ] ://
 [user:passwd@]\fIURL\fP[:port] [options]
+.
 .br
 .in
 .B mplayer
 'in +\n[.k]u
 .I sdp://file
 [options]
+.
 .br
 .in
 .B mplayer
 'in +\n[.k]u
 .I mpst://host[:port]/URL
 [options]
+.
 .br
 .in
 .B gmplayer
 [options]
 [\-skin\ skin]
+.
 .br
 .B mencoder
 [options]
@@ -193,6 +207,7 @@ or remote control (with LIRC).
 The default configuration file for the input system is
 ~/.mplayer/\:input.conf but it can be overriden
 using the \-input option.
+.
 .TP
 .B general control
 .PD 0
@@ -340,24 +355,28 @@ named 'movie.avi.conf' with the file-specific options in it and put it in
 ~/.mplayer or in the same directory as the file.
 .
 .
+.
 .SH "GENERAL OPTIONS"
+.
 .TP
 .B \-codecs-file <filename>
 Use the specified file instead of system wide installed or builtin codecs.conf.
 See also \-afm, \-ac, \-vfm and \-vc.
+.
 .TP
 .B \-include <configuration\ file>
 Specify configuration file to be parsed after the default ones.
+.
 .TP
 .B \-quiet \ \ 
 Make console output less verbose; in particular, prevents the status line
 (i.e.\& A:   0.7 V:   0.6 A-V:  0.068 ...) from being displayed.
 Particularly useful on slow terminals or broken ones which do not properly
 handle carriage return (i.e.\& \\r).
+.
 .TP
 .B \-v, \-verbose
 Increment verbose level (more \-v means more verbosity).
-.
 .PD 0
 .RSs
 .IPs 0
@@ -374,6 +393,7 @@ prints everything related to input parsers (parser debug)
 .
 .
 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
+.
 .TP
 .B \-autoq <quality> (use with \-vf [s]pp)
 Dynamically changes the level of postprocessing depending on the available spare
@@ -381,6 +401,7 @@ CPU time.
 The number you specify will be the maximum level used.
 Usually you can use some big number.
 You have to use \-vf [s]pp without parameters in order for this to work.
+.
 .TP
 .B \-autosync <factor>
 Gradually adjusts the A/\:V sync based on audio delay measurements.
@@ -397,6 +418,7 @@ 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 of playback.
@@ -406,23 +428,27 @@ video codec.
 .I NOTE:
 With this option MPlayer will also ignore frame duration when playing
 only video (you can think of that as infinite fps).
+.
 .TP
 .B \-colorkey <number>
 Changes the colorkey to an RGB value of your choice.
 0x000000 is black and 0xffffff is white.
 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
 xover video out drivers.
+.
 .TP
 .B \-nocolorkey
 Disables colorkeying.
 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
 xover video out drivers.
+.
 .TP
 .B \-edl <filename> (EDL only)
 Enables edit decision list (EDL) actions during playback.
 Video will be skipped over and audio will be muted and unmuted according to
 the entries in the given file.
 See DOCS/\:HTML/\:en/\:edl.html for details on how to use this.
+.
 .TP
 .B \-edlout <filename> (EDL only)
 Creates a new file and writes edit decision list (EDL) records to that file.
@@ -431,10 +457,12 @@ seconds of playback will be written to the file.
 This provides a starting point from which the user can fine-tune EDL entries
 later.
 See DOCS/\:HTML/\:en/\:edl.html for details.
+.
 .TP
 .B \-enqueue (GUI only)
 Enqueue files given on the command line in the playlist instead of playing them
 immediately.
+.
 .TP
 .B \-fixed-vo (BETA CODE!)
 Enforces a fixed video system for multiple files (one (un)initialisation for
@@ -442,23 +470,28 @@ all files).
 Therefore only one window will be opened for all files.
 Currently the following drivers are fixed-vo compliant: gl2, mga, svga, x11,
 xmga, xv, xvidix and dfbmga.
+.
 .TP
 .B \-framedrop (also see \-hardframedrop)
 Skip displaying some frames to maintain A/\:V sync on slow systems.
 Video filters are not applied to such frames.
 For B frames even decoding is skipped completely.
+.
 .TP
 .B \-h, \-help, \-\-help
 Show short summary of options.
+.
 .TP
 .B \-hardframedrop
 More intense frame dropping (breaks decoding).
 Leads to image distortion!
+.
 .TP
 .B \-identify
 Show file parameters in an easily parseable format.
 The wrapper script TOOLS/\:midentify suppresses the other MPlayer output and
 (hopefully) shellescapes the filenames.
+.
 .TP
 .B \-input <commands>
 This option can be used to configure certain parts of the input system.
@@ -497,22 +530,28 @@ several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
 .TP
 .B \-lircconf <file> (LIRC only)
 Specifies a configuration file for LIRC (default: ~/\:.lircrc).
+.
 .TP
 .B \-list-options
 Prints out all the available options.
+.
 .TP
 .B \-loop <number>
 Loops movie playback <number> times.
 0 means forever.
+.
 .TP
 .B \-menu (OSD menu only)
 Turn on OSD menu support.
+.
 .TP
 .B \-menu-cfg <file> (OSD menu only)
 Use an alternative menu.conf.
+.
 .TP
 .B \-menu-root <value> (OSD menu only)
 Specify the main menu.
+.
 .TP
 .B \-noconsolecontrols
 Prevent MPlayer from reading key events from standard input.
@@ -522,20 +561,25 @@ There are situations where you have to set it manually, e.g.\&
 if you open /dev/\:stdin (or the equivalent on your system), use stdin
 in a playlist or intend to read from stdin later on via the loadfile or
 loadlist slave commands.
+.
 .TP
 .B \-nojoystick
 Turns off joystick support.
+.
 .TP
 .B \-nolirc
 Turns off LIRC support.
+.
 .TP
 .B \-nomouseinput (X11 only)
 Disable mouse button press/\:release input (mozplayerxp's context menu relies
 on this option).
+.
 .TP
 .B \-nortc (RTC only)
 Turns off usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
 mechanism.
+.
 .TP
 .B \-playlist <file>
 Play files according to a playlist file (ASX, Winamp, SMIL, or
@@ -546,15 +590,19 @@ This option is considered an entry so options found after it will apply
 only to the elements of this playlist.
 .br
 FIXME: This needs to be clarified and documented thoroughly.
+.
 .TP
 .B \-really-quiet (also see \-quiet)
 Display even less output and status messages than with \-quiet.
+.
 .TP
 .B \-rtc-device <device>
 Use the specified device for RTC timing.
+.
 .TP
 .B \-shuffle
 Play files in random order.
+.
 .TP
 .B \-skin <name> (GUI only)
 Loads a skin from the directory given as parameter below the default skin
@@ -576,21 +624,26 @@ Instead of intercepting keyboard events, MPlayer will read commands from stdin.
 .br
 .I NOTE:
 See DOCS/\:tech/\:slave.txt and \-input cmdlist for a list of slave commands.
+.
 .TP
 .B \-softsleep
 Use high-quality software timers instead of the RTC.
 As precise as the RTC without requiring special privileges.
 Comes at the price of higher CPU consumption.
+.
 .TP
 .B \-speed <0.01\-100>
 Slow down or speed up playback by the factor given as parameter.
+.
 .TP
 .B \-sstep <sec>
 Display one frame every <sec> seconds.
 Useful for slideshows.
 .
 .
+.
 .SH "DEMUXER/\:STREAM OPTIONS"
+.
 .TP
 .B \-a52drc <level>
 Select the Dynamic Range Compression level for AC3 audio streams.
@@ -599,6 +652,7 @@ and 1 (which is the default) means full compression (make loud passages more
 silent and vice versa).
 This option only shows an effect if the AC3 stream contains the required range
 compression information.
+.
 .TP
 .B \-aid <id> (also see \-alang)
 Select audio channel (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127,
@@ -606,6 +660,7 @@ VOB(AC3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
 MPlayer prints the available IDs when run in verbose (\-v) mode.
 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
 (if present) with the chosen audio stream.
+.
 .TP
 .B \-alang <two letter\ country\ code> (also see \-aid) (DVD only)
 Selects the DVD audio language and tries to play audio streams whose
@@ -625,41 +680,48 @@ Plays Hungarian and falls back to English if Hungarian is not available.
 Force audio demuxer type for \-audiofile.
 Give the demuxer ID as defined in libmpdemux/\:demuxer.h.
 \-audio-demuxer 17 forces MP3.
+.
 .TP
 .B \-audiofile <filename>
 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
 movie.
+.
 .TP
 .B \-audiofile-cache <kBytes>
 Enables caching for the stream used by \-audiofile, using the specified
 amount of memory.
+.
 .TP
 .B \-bandwidth <value> (network only)
 Specify the maximum bandwidth for network streaming (for servers that are
 able to send content in different bitrates).
 Useful if you want to watch live streamed media behind a slow connection.
+.
 .TP
 .B \-cdrom-device <path\ to\ device>
 Specify the CD-ROM device (default: /dev/\:cdrom).
+.
 .TP
 .B \-cache <kBytes>
 This option specifies how much memory (in kBytes) to use when precaching a
 file or URL.
 Especially useful on slow media.
+.
 .TP
 .B \-cache-min <percentage>
 Playback will start when the cache fill threshold set with this option
 is reached.
+.
 .TP
 .B \-cache-prefill <percentage> (not yet implemented)
 When the cache is emptied MPlayer will pause and restart playback when
 the cache prefill threshold set with this option is reached.
+.
 .TP
 .B \-cdda <option1:option2> (CDDA only)
 This option can be used to tune the CD Audio reading feature of MPlayer.
 .sp 1
 Available options are:
-.
 .RSs
 .IPs speed=<value>
 Set CD spin speed.
@@ -727,33 +789,41 @@ full 5.1
 .B \-chapter <chapter\ id>[\-<end\ chapter\ id>] (DVD only)
 Specify which chapter to start playing at.
 Optionally specify which chapter to end playing at (default: 1).
+.
 .TP
 .B \-cookies (network only)
 Send cookies when making HTTP requests.
+.
 .TP
 .B \-cookies-file <filename> (network only)
 Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
 and skip reading from default locations.
 The file is assumed to be in Netscape format.
+.
 .TP
 .B \-demuxer <number>
 Force demuxer type.
 Give the demuxer ID as defined in libmpdemux/\:demuxer.h.
 \-demuxer 17 forces MP3.
+.
 .TP
 .B \-dumpaudio (MPlayer only)
 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.
+.
 .TP
 .B \-dumpstream (MPlayer only)
 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).
+.
 .TP
 .B \-dvbin <options> (DVB only)
 Pass the following parameters to the DVB input module, in order to override
@@ -773,10 +843,12 @@ or ~/.mplayer/\:channels.conf as a last resort.
 .TP
 .B \-dvd-device <path\ to\ device> (DVD only)
 Specify the DVD device (default: /dev/\:dvd).
+.
 .TP
 .B \-dvdangle <angle\ id> (DVD only)
 Some DVD discs contain scenes that can be viewed from multiple angles.
 Here you can tell MPlayer which angles to use (default: 1).
+.
 .TP
 .B \-forceidx
 Force index rebuilding.
@@ -787,13 +859,16 @@ You can fix the index permanently with MEncoder (see the documentation).
 .I NOTE:
 This option only works if the underlying media supports seeking
 (i.e.\& not with stdin, pipe, etc).
+.
 .TP
 .B \-fps <float value>
 Override video framerate.
 Useful if the original value is wrong or missing.
+.
 .TP
 .B \-frames <number>
 Play/\:convert only first <number> frames, then quit.
+.
 .TP
 .B \-hr-mp3-seek (MP3 only)
 Hi-res MP3 seeking.
@@ -801,6 +876,7 @@ Enabled when playing from an external MP3 file, as we need to seek
 to the very exact position to keep A/\:V sync.
 Can be slow especially when seeking backwards since it has to rewind
 to the beginning to find an exact frame position.
+.
 .TP
 .B \-idx (also see \-forceidx)
 Rebuilds index of files if no index was found, allowing seeking.
@@ -809,10 +885,12 @@ Useful with broken/\:incomplete downloads, or badly created files.
 .I NOTE:
 This option only works if the underlying media supports seeking
 (i.e.\& not with stdin, pipe, etc).
+.
 .TP
 .B \-ipv4-only-proxy (network only)
 Skip the proxy for IPv6 addresses.
 It will still be used for IPv4 connections.
+.
 .TP
 .B \-loadidx <index file>
 The file from which to read the video index data saved by \-saveidx.
@@ -823,9 +901,11 @@ from a different AVI, but this is sure to cause unfavorable results.
 .br
 .I NOTE:
 This option is obsolete now that MPlayer has OpenDML support.
+.
 .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.
@@ -849,10 +929,12 @@ input file type (available: jpeg, png, tga, sgi)
 .B \-ni (AVI only)
 Force usage of non-interleaved AVI parser (fixes playback
 of some bad AVI files).
+.
 .TP
 .B \-nobps (AVI only)
 Do not use average byte/\:second value for A-V sync.
 Helps with some AVI files with broken header.
+.
 .TP
 .B \-noextbased
 Disables extension-based demuxer selection.
@@ -860,17 +942,21 @@ By default, when the file type (demuxer) cannot be detected reliably
 (the file has no header or it is not reliable enough), the filename
 extension is used to select the demuxer.
 Always falls back to content-based demuxer selection.
+.
 .TP
 .B \-passwd <password> (see \-user option too) (network only)
 Specify password for HTTP authentication.
+.
 .TP
 .B \-prefer-ipv4 (network only)
 Use IPv4 on network connections.
 Falls back to IPv6 automatically.
+.
 .TP
 .B \-prefer-ipv6 (IPv6 network only)
 Use IPv6 on network connections.
 Falls back to IPv4 automatically.
+.
 .TP
 .B \-rawaudio <option1:option2:...>
 This option lets you play raw audio files.
@@ -929,6 +1015,7 @@ Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
 packets be streamed over TCP (using the same TCP connection as RTSP).
 This option may be useful if you have a broken internet connection that does
 not pass incoming UDP packets (see http://www.live.com/\:mplayer/).
+.
 .TP
 .B \-saveidx <filename>
 Force index rebuilding and dump the index to <filename>.
@@ -936,14 +1023,17 @@ Currently this only works with AVI files.
 .br
 .I NOTE:
 This option is obsolete now that MPlayer has OpenDML support.
+.
 .TP
 .B \-sb <byte\ position> (see \-ss option too)
 Seek to byte position.
 Useful for playback from CD-ROM images or VOB files with junk at the beginning.
+.
 .TP
 .B \-srate <Hz>
 Selects the given output sampling rate, resampling if necessary.
 MEncoder passes this value to LAME for resampling.
+.
 .TP
 .B \-ss <time> (see \-sb option too)
 Seek to given time position.
@@ -983,7 +1073,6 @@ or even 'tv://<channel_name> (see option channels for channel_name below)
 as a movie URL.
 .sp 1
 Available options are:
-.
 .RSs
 .IPs noaudio
 no sound
@@ -1104,56 +1193,66 @@ Choose the quality of the JPEG compression
 .TP
 .B \-user <user name> (also see \-passwd) (network only)
 Specify user name for HTTP authentication.
+.
 .TP
 .B \-user-agent <string>
 Use <string> as user agent for HTTP streaming.
+.
 .TP
 .B \-vid <id>
 Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
 (if present) with the chosen video stream.
+.
 .TP
 .B \-vivo <sub-options> (DEBUG CODE)
 Force audio parameters for the VIVO demuxer (for debugging purposes).
 .
 .
+.
 .SH "OSD/\:SUB OPTIONS"
 .I NOTE:
 Also see \-vf expand.
+.
 .TP
 .B \-dumpjacosub (MPlayer only)
 Convert the given subtitle (specified with the \-sub option) to the time-based
 JACOsub subtitle format.
 Creates a dumpsub.js file in the current directory.
+.
 .TP
 .B \-dumpmicrodvdsub (MPlayer only)
 Convert the given subtitle (specified with the \-sub option) to the
 MicroDVD subtitle format.
 Creates a dumpsub.sub file in the current directory.
+.
 .TP
 .B \-dumpmpsub (MPlayer only)
 Convert the given subtitle (specified with the \-sub option) to MPlayer's
 subtitle format, MPsub.
 Creates a dump.mpsub file in the current directory.
+.
 .TP
 .B \-dumpsami (MPlayer only)
 Convert the given subtitle (specified with the \-sub option) to the time-based
 SAMI subtitle format.
 Creates a dumpsub.smi file in the current directory.
+.
 .TP
 .B \-dumpsrtsub (MPlayer only)
 Convert the given subtitle (specified with the \-sub option) to the time-based
 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.
 Also see the \-dump*sub and \-vobsubout* options.
+.
 .TP
 .B \-ffactor <number> (OSD only)
 Resample the font alphamap.
 Can be:
-.
 .PD 0
 .RSs
 .IPs 0
@@ -1170,6 +1269,7 @@ bold black outline
 .TP
 .B \-flip-hebrew (FriBiDi only)
 Turns on flipping subtitles using FriBiDi.
+.
 .TP
 .B \-font <path\ to\ font.desc\ file> (OSD only)
 Search for the OSD/\:SUB fonts in an alternative directory (default for normal
@@ -1194,25 +1294,29 @@ With fontconfig, this option determines the fontconfig font name.
 .TP
 .B \-fontconfig (fontconfig only)
 Enables the usage of fontconfig managed fonts.
+.
 .TP
 .B \-forcedsubsonly
 Display only forced subtitles for the DVD subtitle stream selected by e.g.\&
 \-slang.
+.
 .TP
 .B \-fribidi-charset <charset\ name> (FriBiDi only)
 Specifies the character set that will be passed to FriBiDi when
 decoding non-UTF-8 subtitles (default: ISO8859-8).
+.
 .TP
 .B \-ifo <VOBsub\ ifo\ file>
 Indicate the file that will be used to load palette and frame size for VOBsub
 subtitles.
+.
 .TP
 .B \-noautosub
 Turns off automatic subtitle file loading.
+.
 .TP
 .B \-osdlevel <0\-3> (MPlayer only)
 Specifies which mode the OSD should start in.
-.
 .PD 0
 .RSs
 .IPs 0
@@ -1231,10 +1335,12 @@ volume + seek + timer + percentage + total time
 Allows the next subtitle to be displayed while the current one is
 still visible (default is to enable the support only for specific
 formats).
+.
 .TP
 .B \-sid <ID> (also see \-slang option)
 Display DVD subtitles in the language specified by <ID> (0\-31).
 MPlayer prints the available subtitle languages when run in verbose (\-v) mode.
+.
 .TP
 .B \-slang <country\ code[,country\ code,...]> (also see \-sid)
 Specify a priority list of DVD subtitle languages to use.
@@ -1291,25 +1397,30 @@ align at bottom
 .B \-spugauss <0.0\-3.0> (OSD only)
 Variance parameter of gaussian used by \-spuaa 4.
 Higher means more blur (default: 1.0).
+.
 .TP
 .B \-sub <subtitlefile1,subtitlefile2,...>
 Use/\:display these subtitle files.
 Only one file can be displayed at the same time.
+.
 .TP
 .B \-sub-bg-alpha <0\-255>
 Specify the alpha channel value for subtitles and OSD backgrounds.
 Big values mean more transparency.
 0 means completely transparent.
+.
 .TP
 .B \-sub-bg-color <0\-255>
 Specify the color value for subtitles and OSD backgrounds.
 Currently subtitles are grayscale so this value is equivalente to the
 intensity of the color.
 255 means white and 0 black.
+.
 .TP
 .B \-sub-demuxer <number> (\-subfile only) (BETA CODE)
 Force subtitle demuxer type for \-subfile.
 Give the demuxer ID as defined in subreader.h.
+.
 .TP
 .B \-sub-fuzziness <mode>
 Adjust matching fuzziness when searching for subtitles:
@@ -1328,6 +1439,7 @@ Load all subs in the current directory.
 .B \-sub-no-text-pp
 Disables any kind of text post processing done after loading the subtitles.
 Used for debug purposes.
+.
 .TP
 .B \-subalign <0\-2> (OSD only)
 Specify how subtitles should be aligned with \-subpos.
@@ -1348,6 +1460,7 @@ 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> (iconv only)
 If your system supports iconv(3), you can use this option to
@@ -1386,10 +1499,12 @@ Guess the encoding for Polish, fall back to cp1250.
 .B \-subdelay <sec>
 Delays subtitles by <sec> seconds.
 Can be negative.
+.
 .TP
 .B \-subfile <filename> (BETA CODE)
 Currently useless.
 Same as \-audiofile, but for subtitle streams (OggDS?).
+.
 .TP
 .B \-subfont-autoscale <0\-3> (FreeType only)
 Sets the autoscale mode.
@@ -1415,65 +1530,79 @@ proportional to movie diagonal (default)
 .TP
 .B \-subfont-blur <0\-8> (FreeType only)
 Sets the font blur radius (default: 2).
+.
 .TP
 .B \-subfont-encoding <value> (FreeType only)
 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> (FreeType only)
 Sets the autoscale coefficient of the OSD elements (default: 6).
+.
 .TP
 .B \-subfont-outline <0\-8> (FreeType only)
 Sets the font outline thickness (default: 2).
+.
 .TP
 .B \-subfont-text-scale <0\-100> (FreeType only)
 Sets the subtitle text autoscale coefficient as percentage of the
 screen size (default: 5).
+.
 .TP
 .B \-subfps <rate>
 Specify the framerate of the subtitle file (default: movie fps).
 .br
 .I NOTE:
 Only for frame-based subtitle files, i.e.\& not MicroDVD format.
+.
 .TP
 .B \-subpos <0\-100> (useful with \-vf expand) (OSD only)
 Specify the position of subtitles on the screen.
 The value is the vertical position of the subtitle in % of the screen height.
+.
 .TP
 .B \-subwidth <10\-100> (OSD only)
 Specify the maximum width of subtitles on the screen.
 Useful for TV-out.
 The value is the width of the subtitle in % of the screen width.
+.
 .TP
 .B \-unicode
 Tells MPlayer to handle the subtitle file as unicode.
+.
 .TP
 .B \-utf8 \ \ 
 Tells MPlayer to handle the subtitle file as UTF-8.
+.
 .TP
 .B \-vobsub <VOBsub\ file\ without\ extension>
 Specify a VOBsub file to use for subtitles.
 Has to be the full pathname without extension, i.e.\& without
 the '.idx', '.ifo' or '.sub'.
+.
 .TP
 .B \-vobsubid <0\-31>
 Specify the VOBsub subtitle ID.
 .
 .
+.
 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
+.
 .TP
 .B \-abs <value> (\-ao oss only) (OBSOLETE)
 Override audio driver/\:card buffer size detection.
+.
 .TP
 .B \-aofile <filename>
 Override the default filename employed by \-ao pcm.
+.
 .TP
 .B \-aop <list=plugin1,plugin2...:option1=value1:opt2=val2...>
 Specify audio plugin(s) and their options (see documentation too).
 .sp 1
 Available options are:
-.
 .RSs
 .IPs list=[plugins]
 comma separated list of plugins (resample, surround, format, volume,
@@ -1495,11 +1624,11 @@ compressor / 'soft-clipping' capabilities (volume plugin only)
 .TP
 .B \-delay <sec>
 Audio delay in seconds (positive or negative float value).
+.
 .TP
 .B \-format <0\-8192>
 Select the format used for output from the filter layer (according to the
 defines in libao2/\:afmt.h):
-.
 .PD 0
 .RSs
 .IPs 1
@@ -1535,6 +1664,7 @@ signed 32-bit (big-endian)
 .B \-mixer <device>
 Use a mixer device different from the default /dev/\:mixer.
 For ALSA this is the mixer name.
+.
 .TP
 .B \-mixer-channel <mixer line> (\-ao oss and \-ao alsa only)
 This option will tell MPlayer to use a different channel for controlling
@@ -1545,19 +1675,23 @@ For a complete list of options look for SOUND_DEVICE_NAMES in
 /usr/\:include/\:linux/\:soundcard.h.
 For ALSA you can use the names e.g.\& alsamixer displays, like
 .B Master, Line, PCM.
+.
 .TP
 .B \-nowaveheader (\-ao pcm only)
 Don't include wave header.
 Used for raw PCM.
+.
 .TP
 .B \-volstep <0\-100>
 Set the step size of mixer volume changes in percent of the whole range
 (default: 3).
 .
 .
+.
 .SH "AUDIO OUTPUT DRIVERS (MPLAYER ONLY)"
 Audio output drivers are interfaces to different audio output facilities.
 The syntax is:
+.
 .TP
 .B \-ao <driver1[:suboption1[=value]:...],driver2,...[,]>
 Specify a priority list of audio output drivers to be used.
@@ -1578,7 +1712,6 @@ Try the ALSA driver, then the OSS driver, then others.
 Sets noblock-mode, mmap-mode and the device-name as first card, fourth device.
 .RE
 .PD 1
-.
 .sp 1
 FIXME: Document suboptions for sdl, arts, esd, jack, nas, macosx, sgi, sun,
 dxr2, mpegpes, null, pcm, plugin.
@@ -1599,17 +1732,21 @@ Sets the device name.
 Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
 .RE
 .PD 1
+.
 .TP
 .B alsa1x (OBSOLETE)
 ALSA 1.x audio output driver.
 Obsoleted by the general alsa audio output driver.
+.
 .TP
 .B alsa9 (OBSOLETE)
 ALSA 0.9 audio output driver.
 Obsoleted by the general alsa audio output driver.
+.
 .TP
 .B alsa5\ \ 
 ALSA 0.5 audio output driver.
+.
 .TP
 .B oss\ \ \ \ 
 OSS audio output driver
@@ -1619,79 +1756,101 @@ OSS audio output driver
 Sets the audio-output device (default: /dev/\:dsp).
 .RE
 .PD 1
+.
 .TP
 .B sdl\ \ \ \ 
 Highly platform independent SDL (Simple Directmedia Layer) library
 audio output driver.
+.
 .TP
 .B arts\ \ \ 
 Audio output through the Arts daemon.
+.
 .TP
 .B esd\ \ \ \ 
 Audio output through the ESD daemon.
+.
 .TP
 .B jack\ \ \ \ 
 Audio output through JACK (Jack Audio Connection Kit).
+.
 .TP
 .B nas\ \ \ \ 
 Audio output through NAS.
+.
 .TP
 .B macosx (Mac OS X only)
 Native Mac OS X audio output driver.
+.
 .TP
 .B sgi (SGI only)
 Native SGI audio output driver.
+.
 .TP
 .B sun (Sun only)
 Native Sun audio output driver.
+.
 .TP
 .B win32 (Windows only)
 Native Windows waveout audio output driver.
+.
 .TP
 .B dxr2 (also see \-dxr2) (DXR2 only)
 Creative DXR2 specific output driver.
+.
 .TP
 .B mpegpes (DVB only)
 DVB specific output driver.
+.
 .TP
 .B null\ \ \ 
 Produces no audio output but maintains video playback speed.
 Use \-nosound for benchmarking.
+.
 .TP
 .B pcm (also see \-aofile)
 Raw PCM/\:wave file writer audio output.
 Writes the sound to ./audiodump.wav.
+.
 .TP
 .B plugin\ \ 
 Plugin audio output driver.
 .
 .
+.
 .SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
+.
 .TP
 .B \-aa* (\-vo aa only)
 You can get a list and an explanation of available options executing
 .I mplayer \-aahelp
+.
 .TP
 .B \-adapter <value>
 Set the graphics card that will receive the image.
 Needs the \-vm option to work.
 You can get a list of available cards when you run this option with \-v.
 Works currently only with \-vo directx.
+.
 .TP
 .B \-bpp <depth>
 Override the autodetected color depth.
 Only supported by the fbdev, dga, svga, vesa video output drivers.
+.
 .TP
 .B \-brightness <-100\-100>
 Adjust the brightness of the video signal (default: 0).
 Not supported by all video output drivers.
+.
 .TP
 .B \-contrast <-100\-100>
 Adjust the contrast of the video signal (default: 0).
 Not supported by all video output drivers.
+.
 .TP
 .B \-dfbopts <value> (\-vo directfb only)
 Specify a parameter list for the directfb video output driver.
+.
 .TP
 .B \-display <name> (X11 only)
 Specify the hostname and display number of the X server you want to display
@@ -1712,16 +1871,17 @@ decoding another.
 Can affect OSD negatively, but often it removes OSD flickering.
 Needs twice the memory of a single buffer, so it won't work on cards with
 very little video memory.
+.
 .TP
 .B \-dr \ \ \ 
 Turns on direct rendering (not supported by all codecs and video outputs)
 .br
 .I WARNING:
 May cause OSD/\:SUB corruption!
+.
 .TP
 .B \-dxr2 <option1:option2:...>
 This option is used to control the dxr2 video output driver.
-.
 .RSs
 .IPs ar-mode=<value>
 aspect ratio mode (0 = normal, 1 = pan and scan, 2 = letterbox (default))
@@ -1804,6 +1964,7 @@ Tune the overlay (default: 1000).
 .TP
 .B \-fb <device> (\-vo fbdev or directfb only) (OBSOLETE)
 Specifies the framebuffer device to use (default: /dev/\:fb0).
+.
 .TP
 .B \-fbmode <modename> (\-vo fbdev only)
 Change video mode to the one that is labeled as <modename> in
@@ -1811,19 +1972,24 @@ Change video mode to the one that is labeled as <modename> in
 .br
 .I NOTE:
 VESA framebuffer doesn't support mode changing.
+.
 .TP
 .B \-fbmodeconfig <filename> (\-vo fbdev only)
 Override framebuffer mode configuration file (default: /etc/\:fb.modes).
+.
 .TP
 .B \-forcexv (\-vo sdl only)
 Force using XVideo through the sdl video output driver.
+.
 .TP
 .B \-fs (also see \-zoom)
 Fullscreen playback (centers movie, and paints black bands around it).
 Not supported by all video output drivers.
+.
 .TP
 .B \-fsmode-dontuse <0\-31> (OBSOLETE, use the \-fs option)
 Try this option if you still experience fullscreen problems.
+.
 .TP
 .B \-fstype <type1,type2,...> (X11 only)
 Specify a priority list of fullscreen modes to be used.
@@ -1869,6 +2035,7 @@ unsupported modes are specified.
 Fixes fullscreen switching on OpenBox 1.x.
 .RE
 .PD 1
+.
 .TP
 .B \-geometry x[%][:y[%]] or [WxH][+x+y]
 Adjust where the output is on the screen initially.
@@ -1901,11 +2068,13 @@ Places the window at the bottom right corner of the screen.
 This tells the GUI to also use an X11 window and stick itself to the bottom
 of the video, which is useful to embed a mini-GUI in a browser (with the
 MPlayer plugin for instance).
+.
 .TP
 .B \-hue <-100\-100>
 Adjust the hue of the video signal (default: 0).
 You can get a colored negative of the image with this option.
 Not supported by all video output drivers.
+.
 .TP
 .B \-jpeg <option1:option2:...> (\-vo jpeg only)
 Specify options for the jpeg video output driver.
@@ -1942,12 +2111,15 @@ Must be equal to or larger than 1 (default: 1000).
 .TP
 .B \-monitor-dotclock <range[,range,...]> (\-vo fbdev and vesa only)
 Specify the dotclock or pixelclock range of the monitor.
+.
 .TP
 .B \-monitor-hfreq <range[,range,...]> (\-vo fbdev and vesa only)
 Specify the horizontal frequency range of the monitor.
+.
 .TP
 .B \-monitor-vfreq <range[,range,...]> (\-vo fbdev and vesa only)
 Specify the vertical frequency range of the monitor.
+.
 .TP
 .B \-monitoraspect <ratio> (also see \-aspect)
 Set the aspect ratio of your monitor or TV screen.
@@ -1965,49 +2137,60 @@ Set the aspect ratio of your monitor or TV screen.
 .B \-nograbpointer
 Do not grab the mouse pointer after a video mode change (\-vm).
 Useful for multihead setups.
+.
 .TP
 .B \-nokeepaspect
 Do not keep window aspect ratio when resizing windows.
 Only works with the x11, xv, xmga, xvidix, directx video output drivers.
 Furthermore under X11 your window manager has to honor window aspect hints.
+.
 .TP
 .B \-noxv (\-vo sdl only)