[MPlayer-DOCS] Proposal: split manpages

[Jonas Jermann]

On Sat, Oct 23, 2004 at 06:44:41AM +0200, Ivo wrote:
> 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.

Yeah, as mentioned I'm really against that...

> 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

No, it is interleaved I think....

> 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)

Yeah, that's what I called a "sane" way of doing it...


Regards
	Jonas