[MPlayer-dev-eng] [PROPOSAL] mplayer.1 update (2)

[Arpi]

Hi,

> Changes (2):
>     - reduced to one section (options)
>     - sorted _all_ options alphabetically
>     - commented some options (BETA CODE or OBSOLETE)
>     
> Comments/Reason for 2. patch (my opinion):
>     - old structure was rather burdensome than helpfull
>     - It's easier to add new options that way
>       (or I was to lazy to integrate Arpi's idea ;)
>     - The manpage should better be used as a "reference book"
>     -> It should therefore contain _all_ options and sub-options
>     -> There is already a good documentation which is 
>        structured, explains certain problems etc...

I partially agree, and didn't like the old structure.
But IMHO there are too much options to be mixed up...

And, tehre is a big problem: about 80% of mplayer/mencoder options
are the same! Do you want to make manpages redundant (so both page has the
same options desc?) or what?

Imho, we should split manpage to few major sections:

- demuxer/input options (input media options)
- codecs, vfilters options (decoding/filtering options)
- output (ao/vo) options (ao/vo devices settings)
- mplayer specific options (mostly controls playback flow, looping etc)
- mencoder specific options (out codec selection+options, -pass etc)

then we may do ln -s mplayer.1 mencoder.1

the other possible solution is splitting manpages to 3 manpage - mpcommon,
mplayer and mencoder... but it woul dbe hard to handle by users
note that few big projects, like ncurses or X11 uses this semantics


A'rpi / Astral & ESP-team

--
Developer of MPlayer, the Movie Player for Linux - http://www.MPlayerHQ.hu