dejagnu
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Documentation questions


From: Ben Elliston
Subject: Re: Documentation questions
Date: Wed, 4 Sep 2002 16:21:17 -0400 (EDT)

>>>>> "Rob" == Rob Savoye <address@hidden> writes:

  Rob>   Actually, while this used to be true, more and more projects are either
  Rob> switching to SGML, or starting with it for new projects. While most of 
the
  Rob> older GNU packages do use texinfo, many of the newer ones don't. eCOS 
used
  Rob> SGML, which was my first introduction to it. Cygnus even helped develop
  Rob> some of the Docbook tools we used for that project.

Can you give some examples?  I've not seen any that I can recall.

  Rob>   Back in the beginning, DejaGnu had a TROFF format doc & manpage. Then
  Rob> I rewrote it in texinfo, and now SGML. It's always been worth the
  Rob> incremental improvements in documentation tools.

Except that the various forms of documentation get out of sync with
each other.  Doesn't the current package contain a TROFF man page and
SGML documentation?

  Rob> And the multiple format output is way better.

I agree with you there.

  Rob>   Now that I've found some good tools to make texi output from a Docbook
  Rob> file, I'll probably use that to generate texi, and then info. As I 
already
  Rob> include the docs in ps, rtf, pdf, and html, I might as well add info to 
the
  Rob> list. Probably not for this release though.

Great!

B.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]