Date: Wed, 15 Oct 1997 18:03:13 -0700 (PDT)
Message-Id: <199710160103.SAA04702@adit.ap.net>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
To: mert0407 AT sable DOT ox DOT ac DOT uk (George Foot), djgpp AT delorie DOT com
From: Nate Eldredge <eldredge AT ap DOT net>
Subject: Re: q: va_list and va_start?
Precedence: bulk

At 07:01  10/13/1997 GMT, George Foot wrote:
>On 13 Oct 1997 06:48:04 GMT in comp.os.msdos.djgpp Paul Derbyshire
(ao950 AT FreeNet DOT Carleton DOT CA) wrote:
>
>: For some reason, the djgpp dox documents libc and iostreams, but not basic
>: C constructs like switch and for, C++ ones like class and templates, nor
>: does it document some things like varargs.
>
>To be honest, if someone doesn't know the basic keywords of the language
>they're using, they really ought to read a book or find a tutorial. I think
>that documentation should just cover library components (as it does now). 
>Presumably va_* were left out since they're macros, not functions, but I agree
>that they ought to be included. I also think that useful global variables
>should be mentioned in the docs. Others probably disagree, though (otherwise
>they'd all be in there ;)).
I would guess it was a simple omission. Writing that much documentation and
making it match the library is not easy. If you see something that you think
should be documented, say so! AFAIK, the maintainers would rather err on the
side of over-documenting. Anyway, the va_* macros will be in the docs for
next release.

Nate Eldredge
eldredge AT ap DOT net