Mail Archives: djgpp/1996/12/05/08:44:08
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.
- Raw text -