From nonce at tendra.org  Fri Dec 27 10:36:54 2002
From: nonce at tendra.org (Amos B. Haven)
Date: Fri, 27 Dec 2002 01:36:54 -0800
Subject: FYI: reference in TDF Portability Guide
Message-ID: <20021227093654.GA60095@spill.tendra.org>

Hi,
  In the document "TDF Portability Guide", section 3.2, 4th paragraph,
the sentence:

     For example, in the "Hello world" example discussed in sections
     2.1.1 and 2.1.2, the API specifies that there shall be...

has a bad section reference, and should read instead:

     For example, in the "Hello world" example discussed in sections
     1.1.1 and 1.1.2, the API specifies that there shall be...

I didn't see the sgml in cvs, so I assume this is still in progress.
(I mention this nit because perhaps other hardcoded references are now
off-by-one?)

Looks great, Amar!  I'm amazed at the volume of documents and variety
of supported formats.

-- 
ABH
nonce at tendra.org



From verm at tendra.org  Mon Dec 30 23:23:23 2002
From: verm at tendra.org (Amar Takhar)
Date: Mon, 30 Dec 2002 14:23:23 -0800
Subject: FYI: reference in TDF Portability Guide
In-Reply-To: <20021227093654.GA60095@spill.tendra.org>
References: <20021227093654.GA60095@spill.tendra.org>
Message-ID: <20021230222323.GA31775@tendra.org>

On 2002-12-27 01:36 -0800, Amos B. Haven wrote:
> Hi,
>   In the document "TDF Portability Guide", section 3.2, 4th paragraph,
> the sentence:
> 
>      For example, in the "Hello world" example discussed in sections
>      2.1.1 and 2.1.2, the API specifies that there shall be...
> 
> has a bad section reference, and should read instead:
> 
>      For example, in the "Hello world" example discussed in sections
>      1.1.1 and 1.1.2, the API specifies that there shall be...

Yep that's part of the bad cross referencing that needs to be fixed, *all*
section numbers have changed now that we have gone to sgml, they were previously
static, but we can xref using SGML.  After that, we'll have no worries as it
will follow the section numbers dynamically as we add/remove them.


> I didn't see the sgml in cvs, so I assume this is still in progress.
> (I mention this nit because perhaps other hardcoded references are now
> off-by-one?)

Yeah, unfortunatly it is i had scripts to format it before going into cvs, which
i unfortunatly deleted, i'm about 50% done re-writing them, as soon as i have
completed that all the documentation will be in cvs.


> Looks great, Amar!  I'm amazed at the volume of documents and variety
> of supported formats.

Thanks!, me too, it's an immense ammount of documentation.  As soon as they are
all in cvs we'll have triggered autobuilding, for TXT, HTML, PDF, PDB, DVI and
PS.


Amar.