[MPlayer-dev-eng] Re: [PATCH] Audio filter docs for sound.html

[Forjan Frédéric]

D Richard Felker III wrote:
> On Thu, Jan 02, 2003 at 11:57:25AM +0800, Anders Johansson wrote:
> 
>>Hi,
>>
>>Attached is a patch documenting the audio filters.
>>
>>BTW: The docs are a bit harder to read nowadays. I don't think it was
> 
> 
> I agree they're a bit hard to read...but it annoys me to no end when I
> can't type man blah and find all the command line options available
> for blah. Besides, if this info isn't in the man page, then what
> should be there?
> 
> 
>>a good idea to put all docs in the man page, they are not detailed
>>enough (due to the space limitation), also it is hard to find a
>>specific switch unless one knows exactly what to look for. Wouldn't it
>>be better to use some other more advanced documentation tool, that can
>>produce may different types of documents like for example
>>http://docbook.sourceforge.net/.
> 
> 
> I think one of the long-term project goals is having a good
> topic-oriented manual with source in a high-level format like docbook
> (I forget which particular one the docs people prefer these days).
> Perhaps a good start would be for someone to go through writing a new
> introductory guide to using mplayer and all its features.
> 
> Rich
Hi, we can use some cheat for man, this is the idea from another program 
(don't remember the name)...
If you type "man mplayer" general information are showing. If you want 
more information about an option like channels, type "man 
mplayer_channels". I think it is more easy to find doc like this..
I never make a man page so i don't know thd difficulty to do this.

Frederic Forjan