Mail Archives: djgpp/2002/12/22/14:45:09
> Well, there are a *lot* of frequently asked questions ;-)
>
> > web browsers scrollbar is tiny; difficult to move up and down;
>
> That's not something we can fix. The TOC for the faq is only four
> "pages" long on my browser; I think that's about ideal.
I was referring to the FAQ.html in the zips; the FAQ on the web is actually
too "interdivided" (1 html page for each 0.1 q&a).
> > Readme: too much unrelevant information at the beginning (one has
> > already downloaded and "installed" !);
>
> The README is in the root of the ftp site. That's its intended
> purpose, for people who are about to download it. If you use the zip
> picker, it's instructions pretty much replace the readme.
true; zip picker replaces installation instructions; so it might be a good
idea to have the zip picker pick a zip which contains a readme only with the
neccessary information.
> > User's Guide: link not working;
>
> http://www.delorie.com/djgpp/doc/ug/
>
doesn't work for me:
HTTP-Fehler 406 - Nicht annehmbar
Internet Explorer
IE6.0.2800.1106
> djgpp documentation: most is unrelevant for beginners,
>
> Which ones are you talking about here?
>
the link "Full list of Online Documentation" from .../djgpp. btw.: the Avly
guides are not working: 403 - forbidden.
> > So the whole structure should be clear from the beginning and when
> > one follows a link, one should know in which part of the doc
> > structure one is, that means, what the theme of the section is one
> > has landed in.
>
> If you think you can do better, I'm willing to give you the chance.
like this:
on /djgpp:
djgpp is a C/C++ command-line* development environment (compiler,debugger)
which works under DOS and Windows on 386 PCs and higher and which produces
32-bit DOS executables.
It is the DOS version of the GNU compiler gcc. gcc is one of world top5
compilers compiling C/C++ code for many OS and cpu types. GNU is a software
organisation which produces free software mainly for the UNIX world.
Introductory information and help is provided with the djgpp download.
Detailed information like command-line-arguments to the compiler can be found
on gcc.gnu.org, as they are the origin of the compiler. You will find this
pointer also after you've read the djgpp Usage refernce.
-Download djgpp /* the ZIP picker. as it will show */
/* installation instructions, no need */
/* to mention them here */
-djgpp Usage reference /* the FAQ */
-advanced resources /* the old docs etc. listing */
-More detail on djgppp /* thinks like costs, system requirements */
-Bug reports -C library refernce -newsgroup
*a graphical development environment for DOS as well as extra C/C++ libraries
next to the standardly included standard library whih covers print to screen
etc. which cover graphics display and the like can be downloaded here also
/*------------------------*/
the "djgpp Usage refernece" is the FAQ as in the layout described in my
previous post.
apart from that, I would hve to study all docs o get a clear picture, how to
organise things, but a good idea is a color scheme: each main theme gets a
color. then the further advanced the topics withinf that theme become, the
more is the color changed.
on the main page where the Contents or whatever are is alse a color square
with the main theme names left nmextto it in the 0th column and the levels on
top in the 0th row shown.
then whenever there is a link, there is also a color next to the link, so the
user alread yknows into which direction he is heading when following that
link.
Of course all main themes must be reachable from one main site and it
shouldn#t fall all into pieces. it must be thought about whether eg. inline
assembly syntax eg is a main theme, whether different tutorials are different
levels of the main theme or whether one only decides to show only one tutorial
on delorie.com and that is one main theme and the tutorial is leveld or
whether the inline asm tutorial itself is only a level of a main theme.
Lars
- Raw text -