Re: [Gnu-arch-users] Re: Question about bug 8206

[Thomas Lord]

Alfred M. Szmidt wrote:
>    What is the tool people normally use for authoring info pages?
>
> Emacs.
>   


:-)

I think he wanted an answer like "texinfo" or maybe "docbook".

My opinion, fwiw, is that: (1) It's nice not having redundant doc sources.
(2) It's nice if the doc sources are close to are part of the code they 
apply
to.  (3) It's nice if the doc sources are reasonably attractive as plain
text.    And then derive all the formats you like from that.    Which would
suggest I should be a bigger docbook fan than I actually am but I'm not
(as a source text form), so there.


>    Also is there a tool to easily convert info pages to man pages?
>
> I don't think there is, it wouldn't be very useful.  Info pages can be
> quite long.
>   


man and info tend towards different styles.   info tends to like a lot more
expository content.  

Still, for a reference catalog of commands, where all options are documented
etc.  --- those (should more often than they do) tend towards the same 
style.



>    Can docbook be the source of both man and info pages?
>
> You can make XML files from texinfo.
>
>   

You can also make XML and texinfo from docbook, right?


-t




>    Then what is the best tool for editing docbook documents?
>
> Emacs.
>