[MPlayer-dev-eng] [PATCH] Default CDROM device on OpenBSD

[Rowan James]

On 03/08/2010, at 9:05 PM, Diego Biurrun wrote:

> On Tue, Aug 03, 2010 at 12:27:45PM +0200, Nicolas George wrote:
>> 
>> While I am at it, another wild idea about man page: the man page for zsh is
>> huge, thrice as huge as the one for mplayer. But it is split into small,
>> manageable parts: man zshbuiltins for builtin functions, man zshzle for the
>> line editing system, etc., plus man zshall for all the man pages
>> concatenated, allowing a full-text search. It uses the ".so" feature of
>> *roff: zshall.1 is very small, and ends with a sequence of ".so
>> man1/zshoptions.1", ".so man1/zshbuiltins.1".
>> 
>> I would find a similar split very useful for mplayer: someone who just wants
>> a reminder of the arguments of -ao alsa could type "man mplayer-ao-alsa"
>> instead of searching for "alsa" in the whole manpage (the relevant
>> occurrence is the seventeenth). Someone looking for something in the video
>> filters would type "man mplayer-vf", there would be no risk that his
>> full-text search brings him in the description of a VO.
> 
> I will split the MEncoder man page off of the MPlayer man page, that
> will be a start.
> 

Once the pages are split, perhaps it would make sense to re-map the 'interactive' help to show the relevant man page, more like the Git system?

i.e.
mplayer --usage -> current mplayer --help
mplayer --help -> man mplayer
mencoder --help -> man mencoder

And perhaps later...
mplayer -vf help -> man mplayer-filters
mplayer -ovc help -> man mplayer-codecs

Regards,
    - Rowan