Date:	Thu, 1 Apr 1999 21:39:19 -0500
Message-Id:	<199904020239.VAA26563@envy.delorie.com>
From:	DJ Delorie <dj AT delorie DOT com>
To:	djgpp AT delorie DOT com
In-reply-to:	<bpmurray*STUFFER*-0104991822320001@macmac-2.ucsf.edu>
Subject:	Re: DJGPP Site for Beginners
References:	<3703a1c5 DOT 764307 AT news DOT iafrica DOT com> <199904020009 DOT TAA25067 AT envy DOT delorie DOT com> <bpmurray*STUFFER*-0104991822320001 AT macmac-2 DOT ucsf DOT edu>
Reply-To:	djgpp AT delorie DOT com
X-Mailing-List:	djgpp AT delorie DOT com
X-Unsubscribes-To:	listserv AT delorie DOT com

> What's the intended scope of the guide?  Is it just for gcc or do
> you want guides for the GNU tools?  I realise that the standard GNU
> (and man and info pages) documentation covers some of the aspects
> but there are some platform specific issues (such as running bash)
> that take a little fiddling to get going.

Hmmm... good question.  Here are my thoughts:

* We shouldn't try to duplicate the existing GNU manuals.

* It should be usable by new users, without excluding others.

* If it's djgpp-specific, it's probably OK.

* If you volunteer to write it, I'll probably include it :-)

So, for GNU tools I'd say there should be a section for each of the
popular ones, that show you (by explanation and example) how to
install, configure, and use the tools, but just enough to get them to
the point where they will be ready for the regular GNU manuals.  For
examples, see the "GCC Invocation" section and the "Larger Projects"
chapter, which intro gcc, ar, ranlib, and make.

Also, feel free to write sections that I didn't list.  I can always
use more stuff!  Include a suggested chapter and section name.

Also, some information might also be useful in the HOWTOs at
http://www.delorie.com/howto/ but they'd be written differently.  The
Guide is a guide and learning resource, but the HOWTOs are the raw
(but complete and exact) step-by-step instructions.

- Raw text -