X-Authentication-Warning: delorie.com: mailnull set sender to djgpp-workers-bounces using -f
Date: Tue, 22 Jan 2002 12:57:20 -0500
Message-Id: <200201221757.g0MHvKw23453@envy.delorie.com>
From: DJ Delorie <dj AT delorie DOT com>
To: jeffw AT darwin DOT sfbr DOT org
CC: djgpp-workers AT delorie DOT com, eliz AT is DOT elta DOT co DOT il
In-reply-to: <20020122114417.A15458@kendall.sfbr.org> (message from JT
	Williams on Tue, 22 Jan 2002 11:44:17 -0600)
Subject: Re: djgpp user guide in Texinfo
References: <20020121153543 DOT A15018 AT kendall DOT sfbr DOT org> <4331-Tue22Jan2002111605+0200-eliz AT is DOT elta DOT co DOT il> <200201221414 DOT g0MEEDG21678 AT envy DOT delorie DOT com> <7458-Tue22Jan2002185340+0200-eliz AT is DOT elta DOT co DOT il> <20020122114417 DOT A15458 AT kendall DOT sfbr DOT org>
Reply-To: djgpp-workers AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: djgpp-workers AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk


Each section should retain the original author's name, and be
copyright them.  They wrote them, they get credit.  The ones without
authors were probably written by me.

IMHO the fact that they sent them to me implies a license to
distribute, since there would be no point in contributing them without
such a license.

The division among the three documents, in my mind should be like this:

UG - assume nothing you haven't already covered in previous sections,
act like a tutorial, gloss over "why" in favor of "how".  Very
procedural.

KB - Cover the "why" here, with all the gory details.  No need for
continuity, but each topic should be complete.  Good place to stash
the odd useful email or two.

FAQ - Shortcuts to things that are often asked, even if they're
already documented.