Date: Mon, 8 Jun 1998 19:27:36 +0300 (IDT)
From: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
To: Gili <sl AT psycode DOT com DOT NOSPAM>
cc: djgpp AT delorie DOT com
Subject: Re: DJGPP - overhaul
In-Reply-To: <bWLoegW7sFse-pn2-PBDPNvqPO0kp@portC31.Generation.NET>
Message-ID: <Pine.SUN.3.91.980608192441.11424O-100000@is>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Precedence: bulk


On 8 Jun 1998, Gili wrote:

> which are not properly documented in libc.inf... First, if you're 
> really concerned about compatibility with other plateforms, provide 
> help for their functions which simple says:
> 
> "--- This function does not exist in DJGPP, please refer to equivilent
> functions such as:

This is in the works for the next release.

> information, links to related functions, return values, etc. which is 
> GREAT! I'd love for the entire help to be like that.. But for others, 
> all you have is the syntax (which sometimes is actually incorrect) 
> followed by the return value.. Problem is, you never explain what 
> those return values actually mean, or what related functions exist and
> so on..

The only way to make it better is to sit down and submit a change for the 
missing docs.  Different functions were documented by different people, 
each one with their own preferences and amount of free time.

> 	Yes, I know *everyone* is full of advice they themselves cannot apply
> ;) But I was wondering, who is actually in charge of the documentation
> for DJGPP? If it is you, the author of DJGPP, don't you think you 
> should get a different person to do it for you?

It's everybody, and it's nobody.  More accurately, it's YOU and ME who 
are in charge.  I have just written 20 pages of new docs and submitted 
them to DJ Delorie.  What have YOU done?