Re: RFC: KFAIL DejaGnu patch

[Rob Savoye <rob@welcomehome.org>]

On Mon, Apr 08, 2002 at 04:55:24PM -0400, Andrew Cagney wrote:

> Um, I really have no desire to have to learn yet another documentation 
> language (Ask Eli how painfull it has been having me learn the current 
> one).  Especially when all other GNU projects I'm involved in use texinfo.

  SGML and texinfo are similar enough, I didn't find it that hard to learn
yet another documentation language. Funny enough, I switched to Docbook at
Cygnus, after all the gripes from the doc department. :-) We used it for
eCOS, cause it would generate RTF output, which was a requirement of our
customer.

> Is there any absolutly compelling reason to not convert the current 
> docbook back to texinfo and, instead, stick with that?

  Yes. DocBook is way better than Texinfo at representing technical documents,
than texinfo. Texinfo is great for glorified man pages, but SGML is better
for technical manuals. While most older GNU projects use texinfo, I see that
many newer GNU/Linux projects use DocBook.

  Although I haven't tried it, Abiword supposedly lets you do WYSIWYG
editing of DocBook files. I just use psgml mode for Emacs now.

	- rob -