Sender: rich AT phekda DOT freeserve DOT co DOT uk Message-ID: <396CB05E.52E4775E@phekda.freeserve.co.uk> Date: Wed, 12 Jul 2000 18:52:30 +0100 From: Richard Dawe X-Mailer: Mozilla 4.51 [en] (X11; I; Linux 2.2.14 i586) X-Accept-Language: de,fr MIME-Version: 1.0 To: djgpp-workers AT delorie DOT com Subject: Re: mkdoc patch, take 2 References: Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Reply-To: djgpp-workers AT delorie DOT com Hello. Eli Zaretskii wrote: > > On Tue, 11 Jul 2000, Richard Dawe wrote: > > Are these things mentioned anywhere in the documentation? If not, > > perhaps it is a good idea to add a section to the libc documentation > > that describes the format of each page? Maybe some kind of > > introduction? > > The library internals are not documented at all, and this aspect is one > of the undocumented ones. Actually, what I meant was: is the meaning of the portability described anywhere? Apologies - I lapsed into Rich-speak again, when asking the question. ;) Anyhow, I think a section in the finished manual, explaining what portability means (in practice and ideally), would be a good idea. > There's a template for *.txh files in the djlsr distribution (see > src/mkdoc/sample.txh) which could be used as a stopgap for this specific > piece of information, but this assumes that people actually consult that > file when they work on the docs ;-). Actually, I have read this page. It pretty much shows you everything you need to know. Hopefully (a revised version of) my sample2.txh will do the same with qualifiers, once I've sorted a patch out. Thanks, bye, -- Richard Dawe [ mailto:richdawe AT bigfoot DOT com | http://www.bigfoot.com/~richdawe/ ]