Date: Thu, 5 Dec 1996 15:21:22 +0200 (IST) From: Eli Zaretskii To: ego AT juno DOT com cc: djgpp AT delorie DOT com Subject: Re: Ideas for DJGPP. In-Reply-To: <19961204.165036.8950.0.ego@juno.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII On Wed, 4 Dec 1996 ego AT juno DOT com wrote: > >Can you please tell in detail what are the issues that make DJGPP > >confusing for a newcomer? Thanks. > > Even after i read readme.txt i still didnt know what i needed. Can you tell specifically what isn't clear enough in `readme.1st'? The list of the required and optional files is there, so it must be some kind of wording problem which prevented you from figuring this out. > * Little documentation. Sure the info files are conprehensive, but they > read like a science textbook. DJGPP needs a good manual, in a txt or > html form. It also needs a sort of tutorial manual, Are these good manuals and beginner's tutorials available with other compilers? If so, please tell me which compiler comes with such docs (I have used some of them, and never found anything like that). The DJGPP FAQ and the Knowlegde Base are the equivalent of the (nonexistent, AFAIK) tutorials which other compilers offer. If they aren't good enough, please tell where they should be improved, and they will be better in future releases. > that would explain DJGPP from the beggining to end. Beginning to end? That would be an extremely long and boring reading, much worse than the science textbooks we already have. > perfectly happy with DJGPP. Please do not reply with explanations on why > things are the way they are, I understand perfectly. In order for the docs to be improved, there is a need to identify the gaps and propose what specific items should be documented (if they aren't already) or in what ways should we change this or that piece of docs. Simply saying "I want a tutorial" isn't enough; to be practical, you should at least tell what would you like to see in that tutorial that isn't already described elsewhere. > Maybe if someone put together a package that is just for newbies. it > could contain Everything needed to compile Ansi C programs, RHIDE, a > couple of examples, and maybe some docs. IMHO, this will either leave out too much of the existing docs, or be too large to make a good newbie package. But please feel free to throw together such a package and upload it.