[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