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 <rich AT phekda DOT freeserve DOT co DOT uk>
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:	<Pine DOT SUN DOT 3 DOT 91 DOT 1000712081229 DOT 975B-100000 AT is>
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/ ]

- Raw text -