[MPlayer-dev-eng] [PATCH] man page: Where do you want to go tommorow?

[Diego Biurrun]

Arpi writes:
 > maybe the the installaton could be separated from html docs and put to
 > INSTALL text file, maybe install.html and then drop the text version?

That was my idea, create an INSTALL file that includes the
installation instructions from the README and those from chapter 1 of
the HTML docs.  install.html is also possible.  At first glance I
prefer the classic Unix README/INSTALL pair.

 > > Maybe we should reorganize the man page (again) and put the more
 > > advanced options at the end.  Currently we have
 > > 
 > > DEMUXER/STREAM OPTIONS
 > > DECODING/FILTERING OPTIONS
 > > OSD/SUB OPTIONS
 > > AUDIO OUTPUT OPTIONS (MPLAYER ONLY)
 > > VIDEO OUTPUT OPTIONS (MPLAYER ONLY)
 > > PLAYER OPTIONS (MPLAYER ONLY)
 > > ENCODING OPTIONS (MENCODER ONLY)
 > > KEYBOARD CONTROL
 > > SLAVE MODE PROTOCOL
 > > 
 > > I propose this:
 > > 
 > > KEYBOARD CONTROL
 > > PLAYER OPTIONS (MPLAYER ONLY)
 > > DEMUXER/STREAM OPTIONS
 > > OSD/SUB OPTIONS
 > > AUDIO OUTPUT OPTIONS (MPLAYER ONLY)
 > > VIDEO OUTPUT OPTIONS (MPLAYER ONLY)
 > > DECODING/FILTERING OPTIONS
 > > ENCODING OPTIONS (MENCODER ONLY)
 > > SLAVE MODE PROTOCOL
 > 
 > dunno. why?

To put the more common options up front and hide the esoteric stuff in
the depths of the man page.  The things that people will use
first/most should be at the beginning.  Maybe we should review how we
split the options into sections again.

Diego