Splitting the man page (was: Re: [MEncoder-users] aac encoding with lavc)
poirierg at gmail.com
Thu Sep 28 15:46:35 CEST 2006
On 9/28/06, Fredrik Eriksson <feffese at yahoo.se> wrote:
> On 28-09-2006, at 11:56, Guillaume POIRIER wrote:
> > On 9/28/06, Fredrik Eriksson <feffese at yahoo.se> wrote:
> >> On 28-09-2006, at 10:32, Guillaume POIRIER wrote:
> >> > On 9/27/06, Fredrik Eriksson <feffese at yahoo.se> wrote:
> > In any case, yes, the issue of splitting the manpage has been brought
> > up many times in the past, and hasn't been done for different reasons:
> > mainly because nobody cared to implement a way to do it, and also
> > because no satisfary idea has been provided either.
> Then i just have to at least come up with another idea :)
> mplayer and mencoder needs separate man pages, options that applies
> to both programs could either be in both (easier for users), or just
> in the mplayer page (easier to maintain):
> there are tons of filters, they deserve to be in a separate man page:
> it could also be easier to have the codec specific options in
> separate man pages:
> it's quite bad if you can't add document all features in the man
> pages because it's to big, it makes us poor users confused and
> prevents us from using the full power of the great tools you provide.
> I can't promise anything but if we only can agree to how the man
> pages should be I might be able to assist with the split.
I like your idear. even though it's a big ugly and non-intuitive to
have man pages that don't correspond to an actual binary.... but after
all, the same issue exists for C man pages, so I think it's okay.
Let's see what The GodFather of doc team will think about it.
With DADVSI (http://en.wikipedia.org/wiki/DADVSI), France finally has
a lead on USA on selling out individuals right to corporations!
Vive la France!
More information about the MEncoder-users