[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Gnu-arch-users] export of reference manual
From: |
William Dode |
Subject: |
Re: [Gnu-arch-users] export of reference manual |
Date: |
Wed, 12 May 2004 22:17:21 +0200 |
User-agent: |
Gnus/5.1006 (Gnus v5.10.6) Emacs/21.3 (gnu/linux) |
Tom Lord <address@hidden> writes:
> > From: Matthieu Moy <address@hidden>
>
> > William Dode <address@hidden> writes:
>
> > > Salut,
>
> > Salut !
>
> > > I just write a litle python script to export the reference manual in
> > > somes formats :
>
> > Good job!
>
>
> I just want to add:
>
> That's the original intention. I second the "good job".
>
> In the ideal, cross-referencing, special formatting for stuff that
> should be formatted like computer input or output, etc. should all be
> derivable from --help output. For that matter, the _types_ of
> arguments and of option arguments should be derivable from --help
> output.
There is not a lot of cross-referencing, but i think i can do it
automaticaly.
>
> Probably the current --help output is not 100% consistent with that
> but where it diverges I regard that as bugs.
>
> In other words, please feel free to submit or solicit changes to
> --help output to make it more useful for deriving a reference manual
> this way.
One very little things : there is chapter "help" and command "help"... i
had to force the chapter with an upper case "Help" to don't have the sames !
--
William Dodé - http://flibuste.net