[MPlayer-DOCS] Some more manpage errors?

Torinthiel torinthiel at megapolis.pl
Tue Aug 17 19:41:45 CEST 2004


Lines 203, 235, 1530 - double space is intended?

Lines 1477, 3306, 3969, 4570, 4908, 4921, 5036, 5048, 5063, 5562 - Is it
full sentence or not? (i.e capitalization/full stop consistency)

Line 1726 - (default: *) style (it generally needs a consistency run,
but I don't have time for it now).

Line 1492 - Ok, I know it says 'do not use'. But it should say (delay
plugin only) as well, IMHO. And the plugin list 2 lines above should
mention delay, as well.

Lines 4743 and 4757 - Shouldn't the note form the second line go on the
first line? At least the option matches then.

Line 3624 - The 'and' makes no sense to me.

Line 4576 - vqmin is not an option (no '-' before it)

Lines 5276-5278, 5281-5282, 5366-5370: These are punctuated as not full sentences.
However, when groff processes the text it will meld into one piece of
text.

Line 5324, Deletion of (default*) from here did more harm than good. Now
I don't have any idea what quantizers mpeg_quant forces.

Lines 5356, 5347, 5357, 5358: '1or2' looks better as '1 or 2' for me.

Patch included,
Torinthiel

-- 
 Waclaw "Torinthiel" Schiller       GG#: 542916, 3073512
   torinthiel(at)megapolis(dot)pl
   gpg: B06901F1 fpr: FAA3 559F CAE9 34DE CDC8  7346 2B6E 39F2 B069 01F1
 "No classmates may be used during this examination"
-------------- next part --------------
Index: mplayer.1
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/man/en/mplayer.1,v
retrieving revision 1.653
diff -u -r1.653 mplayer.1
--- mplayer.1	16 Aug 2004 00:23:00 -0000	1.653
+++ mplayer.1	17 Aug 2004 17:40:07 -0000
@@ -200,7 +200,7 @@
 .IPs "<\- and \->"
 seek backward/\:forward 10 seconds
 .IPs "up and down"
-seek backward/\:forward  1 minute
+seek backward/\:forward 1 minute
 .IPs "pgup and pgdown"
 seek backward/\:forward 10 minutes
 .IPs "< and >"
@@ -232,7 +232,7 @@
 .IPs o\ \ \ \ 
 toggle OSD states: none / seek / seek + timer / seek + timer + total time
 .IPs d\ \ \ \ 
-toggle frame dropping states:  none / skip display / skip decoding
+toggle frame dropping states: none / skip display / skip decoding
 (see \-framedrop and \-hardframedrop)
 .IPs v\ \ \ \ 
 toggle subtitle visibility
@@ -1474,7 +1474,7 @@
 .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 \-aofile <filename>
 Filename for \-ao pcm.
@@ -1487,9 +1487,9 @@
 .RSs
 .IPs list=[plugins]
 comma separated list of plugins (resample, surround, format, volume,
-extrastereo, volnorm)
+extrastereo, volnorm, delay)
 .IPs delay=<sec>
-example plugin, do not use.
+example plugin, do not use (delay plugin only)
 .IPs format=<format>
 output format (format plugin only)
 .IPs fout=<Hz>
@@ -1527,7 +1527,7 @@
 .IPs 64
 Unsigned 16-bit (Big-Endian)
 .IPs 128
-Signed  16-bit (Little-Endian)
+Signed 16-bit (Little-Endian)
 .IPs 256
 Signed 16-bit (Big-Endian)
 .IPs 512
@@ -1723,7 +1723,7 @@
 .TP
 .B \-dr \ \ \ 
 Turns on direct rendering (not supported by all codecs and video outputs)
-(default is off).
+(default: off).
 Warning: may cause OSD/\:SUB corruption!
 .TP
 .B \-dxr2 <option1:option2:...>
@@ -3303,7 +3303,7 @@
 (\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc).
 .RSs
 .IPs aspect
-control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
+Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
 576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV.
 .RE
 .TP
@@ -3621,7 +3621,7 @@
 Only the luma plane is used to find the frame breaks.
 If a field has no match, it is deinterlaced with simple linear
 approximation.
-If the source is MPEG-2, and this must be the first filter to allow
+If the source is MPEG-2, this must be the first filter to allow
 access to the field-flags set by the MPEG-2 decoder.
 Depending on the source MPEG, you may be fine ignoring this advice, as
 long as you do not see lots of "Bottom-first field" warnings.
@@ -3966,7 +3966,7 @@
 .IPs "xpos, ypos"
 start blitting at X/Y position
 .IPs alpha
-set alpha difference.
+set alpha difference
 If you set this to -255 you can then send a sequence of ALPHA-commands to set
 the area to -225, -200, -175 etc for a nice fade-in-effect! ;)
 .RSss
@@ -4567,13 +4567,13 @@
 .RE
 .TP
 .B lmax=<0.01\-255.0>
-maximum lagrange multiplier for ratecontrol (default: 31.0).
+maximum lagrange multiplier for ratecontrol (default: 31.0)
 .RE
 .TP
 .B vqscale=<1\-31>
 Constant quantizer /\: constant quality encoding (selects fixed quantizer mode).
 A lower value means better quality but larger files (default: 0 (disabled)).
-1 is not recommended (see \-vqmin for details).
+1 is not recommended (see vqmin for details).
 .TP
 .B vqmax=<1\-31>
 maximum quantizer (pass\ 1/\:2) 10\-31 should be a sane range (default: 31)
@@ -4743,6 +4743,9 @@
 1000\-100000 is a sane range.
 (warning: 1kBit = 1000 Bits)
 (default: 8000)
+.I NOTE:
+vratetol should not be too large during the second pass or there might
+be problems if vrc_(min|max)rate is used.
 .TP
 .B vrc_maxrate=<value>
 maximum bitrate in kbit/\:sec (pass\ 1/\:2)
@@ -4754,9 +4757,6 @@
 buffer size in kbit (pass\ 1/\:2).
 For MPEG1/2 this also sets the vbv buffer size, use 327 for VCD,
 917 for SVCD and 1835 for DVD.
-.I NOTE:
-vratetol should not be too large during the second pass or there might
-be problems if vrc_(min|max)rate is used.
 .TP
 .B vrc_buf_aggressivity
 currently useless
@@ -4905,7 +4905,7 @@
 .PD 1
 .TP
 .B vlelim=<-1000\-1000>
-single coefficient elimination threshold for luminance.
+single coefficient elimination threshold for luminance
 Negative values will also consider the dc coefficient (should be at least -4
 or lower for encoding at quant=1):
 .PD 0
@@ -4918,7 +4918,7 @@
 .PD 1
 .TP
 .B vcelim=<-1000\-1000>
-single coefficient elimination threshold for chrominance.
+single coefficient elimination threshold for chrominance
 Negative values will also consider the dc coefficient (should be at least -4
 or lower for encoding at quant=1):
 .PD 0
@@ -5033,7 +5033,7 @@
 .PD 1
 .TP
 .B lumi_mask=<0.0\-1.0>
-luminance masking.
+Luminance masking.
 Warning: Be careful, too large values can cause disastrous things.
 Warning2: Large values might look good on some monitors but may look horrible
 on other monitors:
@@ -5045,7 +5045,7 @@
 .RE
 .TP
 .B dark_mask=<0.0\-1.0>
-darkness masking.
+Darkness masking.
 Warning: be careful, too large values can cause disasterous things.
 Warning2: large values might look good on some monitors but may look horrible
 on other monitors / TV / TFT:
@@ -5060,7 +5060,7 @@
 temporal complexity masking (default: 0.0 (disabled))
 .TP
 .B scplx_mask=<0.0\-1.0>
-spatial complexity masking.
+Spatial complexity masking.
 Larger values help against blockiness, if no deblocking filter is used for
 decoding.
 Tip: Crop any black borders completely as they will reduce the quality
@@ -5273,13 +5273,13 @@
 .PD 1
 .TP
 .B cbp\ \ \ \ 
-Rate distorted optimal coded block pattern
-will select the coded block pattern which minimizes distortion + lambda*rate
-this can only be used together with trellis quantization
+Rate distorted optimal coded block pattern.
+Will select the coded block pattern which minimizes distortion + lambda*rate.
+This can only be used together with trellis quantization.
 .TP
 .B mv0\ \ \ \ 
-try to encode each MB with MV=<0,0> and choose the better one
-this has no effect if mbd=0
+Try to encode each MB with MV=<0,0> and choose the better one.
+This has no effect if mbd=0.
 .TP
 .B qprd\ \ \ 
 rate distorted optimal QP for the given lambda of each macroblock, note this
@@ -5321,7 +5321,7 @@
 Returned values are in dB (decibel), the higher the better.
 .TP
 .B mpeg_quant
-Use MPEG quantizers instead of H.263 (i.e.\& use H.263 quantizers).
+Use MPEG quantizers instead of H.263.
 .TP
 .B aic\ \ \ \ 
 ac prediction (=advanced intra prediction for H.263+)
@@ -5343,8 +5343,8 @@
 H.263 style quantizer default: 0
 .br
 .I NOTE:
-The H.263 MMX quantizer cannot handle positive biases (set vfdct=1or2),
-the MPEG MMX quantizer cannot handle negative biases (set vfdct=1or2).
+The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2),
+the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2).
 .TP
 .B pbias=<-256\-256>
 inter quantizer bias (256 == 1.0)
@@ -5354,8 +5354,8 @@
 H.263 style quantizer default: -64
 .br
 .I NOTE:
-The H.263 MMX quantizer cannot handle positive biases (set vfdct=1or2),
-the MPEG MMX quantizer cannot handle negative biases (set vfdct=1or2).
+The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2),
+the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2).
 .br
 Tip: a more positive bias (-32 \- -16 instead of -64) seems to improve the PSNR
 .TP
@@ -5363,11 +5363,11 @@
 noise reduction, 0 is disabled
 .TP
 .B qns=<0\-3>
-quantizer noise shaping, reduces ringing artefacts, larger values are slower
-but may not result in better quality
-this can and should be used together with trellis quantization, in which case
-the trellis quantization (optimal for constant weight) will be used as startpoint
-for the iterative search.
+Quantizer noise shaping, reduces ringing artefacts, larger values are slower
+but may not result in better quality.
+This can and should be used together with trellis quantization, in which case
+the trellis quantization (optimal for constant weight) will be used as
+startpoint for the iterative search.
 .PD 0
 .RSs
 .IPs 0
@@ -5559,7 +5559,7 @@
 decodable by ISO-MPEG4 decoders except DivX/libavcodec/XviD.
 .br
 .I WARNING:
-this will also store a fake DivX version in the file so the bug
+This will also store a fake DivX version in the file so the bug
 autodetection of some decoders might be confused.
 .TP
 .B divx5bvop
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <http://lists.mplayerhq.hu/pipermail/mplayer-docs/attachments/20040817/3a62444f/attachment.pgp>


More information about the MPlayer-DOCS mailing list