X-Authentication-Warning: delorie.com: mailnull set sender to djgpp-workers-bounces using -f
Message-ID: <3C25BF72.EEA70893@is.elta.co.il>
Date: Sun, 23 Dec 2001 13:26:42 +0200
From: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
X-Mailer: Mozilla 4.04 [en] (WinNT; I)
MIME-Version: 1.0
To: djgpp-workers AT delorie DOT com
Subject: Re: djgpp: djgpp/src/docs/kb/develop.txi
References: <200112202012 DOT fBKKC3818592 AT delorie DOT com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Reply-To: djgpp-workers AT delorie DOT com

> Date: Thu, 20 Dec 2001 15:12:03 -0500
> From: "cvs-richdawe AT delorie DOT com" <cvs AT delorie DOT com>
> 
> ! Any C library sources defining or calling the implementation
> ! should include @file{libc/stubs.h} as the first include file.
> ! This is so that we can refer to e.g. @code{fsync} as @code{fsync}
> ! in the library code, but the library code will actually define/call
> ! e.g. @code{__fsync} and will not pollute the application namespace.
> ! 
> ! The stub files are assembly language files generated automagically
> ! from @file{libc/stubs.h} as part of the C library build process.
> ! 
> ! NB: The private name, e.g. @code{__fsync}, is @strong{not} part of
>   the published API.

This is fine, but please either follow "e.g." with a comma (as I
believe the rules of English require), or with a "@:" Texinfo command,
like so:

  NB: The private name, e.g.@: @code{__fsync}, is @strong{not} part of...

That's because in the printed version of the manual, TeX will typeset
any dot followed by a space as if it ended a sentence; @: prevents
that damage.