Re: [Gnu-arch-users] export of reference manual

[William Dode]

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