[MPlayer-DOCS] r21654 - trunk/DOCS/man/en/mplayer.1

[The Wanderer]

Diego Biurrun wrote:

> On Sun, Dec 17, 2006 at 07:26:42PM +0100, kraymer wrote:
> 
>> Log:
>> add man page entry for new -dvd-speed option
>> 
>> --- trunk/DOCS/man/en/mplayer.1	(original)
>> +++ trunk/DOCS/man/en/mplayer.1	Sun Dec 17 19:26:42 2006
>> @@ -1253,6 +1253,20 @@
>> +.B \-dvd-speed <factor or speed in KB/s> (DVD only)
>> +Try to limit DVD speed (default: 0, don't change speed).
> 
> Please avoid short forms in the man page, so "no speed change".

...or "do not change speed" - although all of these forms have problems
of their own which I'm not sure how to eliminate.

>> +.I NOTE:
>> +You need write permission to the DVD device to change the speed.
> 
> "write permission on"?  I'm not sure about this, Wanderer?

This is a complicated one. I *think* that strictly in a phrasing like
that "on" would be correct, but I also don't think I'd ever use that
phrasing; I would say either e.g. "You don't have permission to write to
that file" or "You don't have write access to that file", avoiding the
question entirely. The latter form could be adapted here ("You need
write access to the DVD device"), but the result is still not ideal.

-- 
       The Wanderer

Warning: Simply because I argue an issue does not mean I agree with any
side of it.

Secrecy is the beginning of tyranny.