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 08:00:18 PST
Path: archiver1.google.com!postnews1.google.com!not-for-mail
From: dennison@telepath.com (Ted Dennison)
Newsgroups: comp.lang.ada
Subject: Re: Announce: Grace project site operational
Date: 14 May 2002 08:00:18 -0700
Organization: http://groups.google.com/
Message-ID: <4519e058.0205140700.51a91225@posting.google.com>
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>
NNTP-Posting-Host: 65.115.221.98
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 8bit
X-Trace: posting.google.com 1021388418 14510 127.0.0.1 (14 May 2002 15:00:18
 GMT)
X-Complaints-To: groups-abuse@google.com
NNTP-Posting-Date: 14 May 2002 15:00:18 GMT
Xref: archiver1.google.com comp.lang.ada:24025
Date: 2002-05-14T15:00:18+00:00
List-Id: <comp.lang.ada>

Stephen Leake <stephen.a.leake.1@gsfc.nasa.gov> wrote in message news:<uznz4nfd7.fsf@gsfc.nasa.gov>...
> Before we have more discussion, I'd like to make sure there is a
> mechanism for capturing the resultant decision and rationale in a
> useful way, so we don't have to do it again next year :).

Dang, that makes good sense. It needs to be up on the website
somewhere to, so we can point people who want to reopen old wounds to
it.

> 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.

> 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, 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.

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.

> Of course, flat ASCII isn't bad!
I'd go for HTML before that, just to get a little formatting.

-- 
T.E.D. 
Home     -  mailto:dennison@telepath.com (Yahoo: Ted_Dennison)
Homepage -  http://www.telepath.com/dennison/Ted/TED.html (down)