[MPlayer-DOCS] Proposal: split manpages

[Ivo]

On Saturday 23 October 2004 06:17, D Richard Felker III wrote:
> i'm absolutely against xml for the man page unless the xml->man
> conversion can be done with no external dependencies whatsoever. it's
> bad enough to need some silly xml progs to generate the docs (but i
> don't read docs anymore anyway, or if i do i can just find them on the
> website). but not being able to read the manpage from cvs without
> having special doc tools installed would really suck!! (and it would
> lead to users not rtfm'ing!!! :/ )

I agree. No special tools.

Isn't it possible to have something like this:  (i'm not a roff expert, so 
don't laugh)

Have a common header and footer, have an mplayer specific file and mencoder 
specific file and build scripts that do something like:

(cat header; cat mplayer_specific; cat footer) > mplayer.1
(cat header; cat mencoder_specific; cat footer) > mencoder.1

or a variation on this with more than three common and specific files 
interleaved? (i.e. first one with all the macro's et cetera)

--Ivo