[MPlayer-DOCS] CVS: main/DOCS/man/en mplayer.1,1.706,1.707

[Diego Biurrun]

On Tue, Sep 07, 2004 at 10:27:10PM +0200, Guillaume Poirier CVS wrote:
> 
> +.B debug\ \ 
> +Save per-frame statistics in ./xvid.dbg (this is
> +.B not
> +the 2pass control file).

I'd capitalize and end in a period inside the parentheses.

Hmm, is this warning necessary?  I wouldn't have thought there is danger of
confusing them..

>  .B divx5bvop
> -generate DivX5 compatible B-frames (default: on)
> +generate DivX5 compatible B frames (default: on)

Capitalize and end in a period.

> +.B max_bframes=<0\-4>
> +maximum number of B frames to put between I/\:P frames (default: 0)

Capitalize and end in a period.

> +You can build such a file with xvid4conf's matrix editor.

I'd prefer "with the xvid4conf matrix editor".

> +You can build such a file with xvid4conf's matrix editor.

dito

> +Obviously, the two pass Rate Controller tries to compensate for that overflow,

rate controller

> +distributing it over next frames to be encoded.

I'd say "over the next encodable frames" or even just "over the next
frames".

> +This setting controls how much of the overflow is distributed at each new
> +frame.

Don't you mean "distributed to"?  The question is: Is the overflow given to
each new frame or distributed afresh each time there is a new frame.  In the
former case I would suggest "overflow is given to each frame", in the latter
case "overflow is distributed every time there is a new frame".

> +more slowly (could lead to lack of precision for small clips).

I'd capitalize and end in a period inside the parentheses.

> +We decided to allow users to set the amount of overhead per frame the
> +container generates (give only an average per frame).

"We" is not the man page style.  Just say "XviD allows users".

> +.B par=<mode>
> +Specifies the Pixel Aspect Ratio mode, which is not to be confused with DAR
> +which is Display Aspect Ratio.

IMHO slightly better:

Specifies the Pixel Aspect Ratio mode (not to be confused with Display
Aspect Ratio - DAR).

Diego