Date: Sun, 5 Jan 1997 11:26:19 -0500 Message-Id: <199701051626.LAA24311@delorie.com> From: DJ Delorie To: eliz AT is DOT elta DOT co DOT il CC: djgpp-workers AT delorie DOT com In-reply-to: (message from Eli Zaretskii on Sun, 5 Jan 1997 18:14:16 +0200 (IST)) Subject: Re: DJGPP User's Guide > > Well, I've finally started working on a DJGPP User's Guide. > > I'm confused. Didn't you want to migrate the current FAQ into a UG? If > not, what should we (read: I) do with the FAQ chapters that explain the > same things that the Guide will explain? IMHO, having 2 documents that > deal with the same issues will add to confusion. Yes, I plan on migrating a lot of that information, but as you said the last time we talked about this, the FAQ's format and content aren't the same as what a UG would want. That's why I'm starting with the TOC and giving everyone a chance to make sure the layout and topics are correct before I start filling it. > > At this time, I'm working on the layout of the Guide, what will become > > the table of contents. At this stage, input from others about the > > topics that need to be covered is almost mandatory, since I already > > know how to use djgpp :-) so please send me your suggestions! > > The first 20 chapters of the FAQ seem like a good starting point. Some > sections there are too question-oriented to be put into a Guide, but most > of them should be in the Guide, with a slightly different wording (maybe). I did use the FAQ's table of contents as a starting point. The Guide will be more of a tutorial, though, so some rearranging is inevitable, some new sections will have to be added, and some FAQs will be left out (and put in the Book Project, I hope).