[MPlayer-DOCS] Proposal: split manpages

[Dominik 'Rathann' Mierzejewski]

On Friday, 22 October 2004 at 14:23, Carl F?rstenberg wrote:
> On Fri, 22 Oct 2004 05:55:53 -0400, D Richard Felker III
> <dalias at aerifal.cx> wrote:
> > On Fri, Oct 22, 2004 at 11:31:19AM +0200, Jiri Heryan wrote:
> > > Torinthiel wrote:
> > >
> > > >On Fri, Oct 22, 2004 at 12:53:52AM +0200, Carl F?rstenberg wrote:
> > > >
> > > >
> > > >>Tried to find, but no luck, is ther any way to search old archives,
> > > >>
> > > >>
> > > >
> > > >http://www.mplayerhq.hu/cgi-bin/s-arch.cgi?sbm=mplayer-dev-eng
> > > >or
> > > >http://news.gmane.org/gmane.comp.video.mplayer.devel
> > > >
> > > >And about splitting - if you come with a sensible way of doing it, than
> > > >maybe. But "sensible" means (as was discussed before) everything needed
> > > >to use M{Player,Encoder} is in m{player,encoder}.1 (so no
> > > >mplayer-common.1 or so, and nothing like "see also mplayer.1" in
> > > >mencoder.1. And it also means no text duplication in CVS, as this will
> > > >for sure get out of sync. Any ideas? If you have a good one, I can help
> > > >you with the build system.
> > > >Torinthiel
> > > >
> > > >
> > > >
> > > >
> > > >
> > > What about split mplayer.1 into separate files in common format (i.e.
> > > XML) by sections (header.xml; ...; codecsopt.xml, etc.). Then you can
> > > have one original in cvs and in main files (mplayer.xml; mencoder.xml)
> > > will be include commands only.
> > >
> > > Well it's idea only :-)
> > 
> > imo the amount of infor that's _not_ duplicate between mplayer and
> > mencoder is relatively very small. as such, i don't see a good
> > justification for splitting the man page..
> > 
> > btw man files are not .xml... :)
[aieee! cut the sigs, please!] 
>
> first we have row 4762 to 7133 that is mencoder only, then it's a lot
> of sections marked mplayer only. also it's many places thats marked
> only suitable in mplayer/mencoder.
> 
> I just proposed to split out everything that was mencoder only to a own
> manpage.

We've been discussing it with Rich in another thread (last month?)
and on IRC. There was an idea to split some common parts like
codecs, filters and audio filters into separate manpages. Rich, are
you still in favour of that?

R.

-- 
MPlayer RPMs maintainer: http://greysector.rangers.eu.org/mplayer/
"I am Grey. I stand between the candle and the star. We are Grey.
 We stand between the darkness ... and the light."
        -- Delenn in Grey Council in Babylon 5:"Babylon Squared"