[MPlayer-DOCS] Need help documenting dsize

[The Wanderer]

(Hmm. I've got time enough to handle these, maybe I should go back and 
dig through some of my un-commented-on backlog fairly soon? Then again,
some of it's not only already committed but months old...)


Oded Shimon wrote:

> +New display width and height.
> +Can also be these special values:
> +.RSss
> + 0:   Original display width, height.
> +.br
> +-1:   Original video width and height. (default)

Unless there's some specific reason to do otherwise, these two should 
probably be phrased in the same way.

> +.br
> +-2:   Calculate by using the other dimention and the original video aspect ratio.
> +.br
> +-3:   Calculate by using the other dimention and the original display aspect ratio.

"dimension", in both cases.

> +.REss
> +.sp 1
> +.I EXAMPLE:
> +.PD 0
> +.RSs
> +.IP dsize=800:-2
> +Specifies a dsize of 800x600 for a 4/\:3 aspect movie.

I'd clarify this some more; I figured out what it meant after a few
seconds, but J. Random User won't necessarily. Specifically, this leaves
the potential for misinterpretation around the idea of "what does it do
for a movie which isn't 4:3?"; the best solution I've been able to come
up with is to append ", or 800x450 for a 16:9 aspect movie", but that
isn't really satisfactory.

You might also want to say "video" here instead of "movie", just because
formally speaking not all video files necessarily represent "movies" in
the modern sense (although they almost certainly are "moving picures"),
in line with my comment on your previous commit; here as there, however,
it's optional.

> +.RE
> +.IPs <aspect\-method>
> +Modifies width and height according to original aspect ratios.

Ratios, plural? If that's really what you meant, then I'm a little
confused, since I wasn't aware that a single file could have multiple
aspect ratios.

> +Round width and hieght up to be divisable by <r>. (default: 1)

"divisible", again

-- 
       The Wanderer

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

A government exists to serve its citizens, not to control them.