From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=ham
	autolearn_force=no version=3.4.4
X-Google-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: 103376,1dd28d5040ded1f8
X-Google-Attributes: gid103376,public
X-Google-ArrivalTime: 2002-05-14 09:04:25 PST
Path: 
 archiver1.google.com!news1.google.com!newsfeed.stanford.edu!logbridge.uoregon.edu!hammer.uoregon.edu!skates!not-for-mail
From: Stephen Leake <stephen.a.leake.1@gsfc.nasa.gov>
Newsgroups: comp.lang.ada
Subject: Re: Announce: Grace project site operational
Date: 14 May 2002 12:00:06 -0400
Organization: NASA Goddard Space Flight Center (skates.gsfc.nasa.gov)
Message-ID: <uvg9qu3cp.fsf@gsfc.nasa.gov>
References: <3CD88FBD.4070706@telepath.com>
 <MwGUb1cULPdB@eisner.encompasserve.org> <3CD91E31.1060004@telepath.com>
 <abb9fs$7cc$1@nh.pace.co.uk> <3CDBD673.FF452A3D@otelco.net>
 <abgph8$p0d$1@nh.pace.co.uk> <3CDD75C7.36C6ADCF@acm.org>
 <4519e058.0205130744.2602e251@posting.google.com>
 <uznz4nfd7.fsf@gsfc.nasa.gov>
 <4519e058.0205140700.51a91225@posting.google.com>
NNTP-Posting-Host: anarres.gsfc.nasa.gov
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Trace: skates.gsfc.nasa.gov 1021392403 27437 128.183.220.71 (14 May 2002
 16:06:43 GMT)
X-Complaints-To: usenet@news.gsfc.nasa.gov
NNTP-Posting-Date: 14 May 2002 16:06:43 GMT
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.2
Xref: archiver1.google.com comp.lang.ada:24032
Date: 2002-05-14T16:06:43+00:00
List-Id: <comp.lang.ada>

dennison@telepath.com (Ted Dennison) writes:

> Stephen Leake <stephen.a.leake.1@gsfc.nasa.gov> wrote in message
> news:<uznz4nfd7.fsf@gsfc.nasa.gov>...
> 
> > For example, a design and rational document for Grace would be good
>                             ^^^^^^^^
>                             rationale.
> I'm the worst person in here to be dissin' on someone else's spelling,
> but this one always rubs me the wrong way. Sorry.

It bugs me too :). But I don't run a spell checker on email or news
(wouldn't have caught this anyway). And I try to tone down my personal
checker, since I know I make mistakes too. Life is too short ...

> > Now I'll start another controversy; do it in LaTeX :).
> > 
> > Actually, I think texinfo is good for Gnu projects. Some seem to be
> > using DocBook, which I've never used.
> 
> From what I understand about it, I'd be inclined to pick texinfo
> (which I understand is a flavor of TeX) out of the choices you have
> above. It is the official Gnu doc system, 

Apparently that's true: http://www.gnu.org/prep/standards.html#SEC33
I had not realized that before.

> so that's what all the Gnu tools are set up to use. Also, it
> provides for producing both HTML and typeset versions. Apparently it
> can be processed by TeX proceesors too.

Using the Gnu program 'makeinfo', you can produce html, info, or TeX
output. If you produce TeX, you can then use the 'tex' program to
produce PDF, PS, or other 'hardcopy' formats. 'info' is an old
hyperlinked format (oldest I'm aware of); the best reader for it is
Emacs. 

> Note that no-one would deal with the texinfo documentation "sources"
> directly, unless they are updating them. Readers would use either
> the generated HTML versions, or some ready-for-printing format like
> Postscript or Acrobat.

Yes. I recommend PDF; the latest version has 'bookmarks', which are
like an always-visible, interactive table of contents.

-- 
-- Stephe