Re: Inconsistencies in our SGML output - Mailing list pgsql-docs

From Peter Eisentraut
Subject Re: Inconsistencies in our SGML output
Date
Msg-id Pine.LNX.4.56.0308191013170.4847@krusty.localdomain
Whole thread Raw
In response to Inconsistencies in our SGML output  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
Tom Lane writes:

> Does anyone know why the very same cross-reference,
>      <xref linkend="reference">
> renders as "Part VI" here:
>     http://developer.postgresql.org/docs/postgres/sql.html
> and on the next page as "Part VI in PostgreSQL 7.4beta1 Documentation":
>     http://developer.postgresql.org/docs/postgres/sql-syntax.html
> Given that we're building just one book now, the latter form seems
> overly verbose to me.

Apparently, there is a bug in the stylesheets.  I'm looking at it.

> Another oddity can be seen in the table of contents for the plpgsql
> chapter,
>     http://developer.postgresql.org/docs/postgres/plpgsql.html
> Why is there no TOC entry for subsection 40.2.1?  It seems to be made
> with <sect2> just the same as the other subsections.

The stylesheets deliberately don't make a TOC for a particular level if
it would consist of just one entry.

--
Peter Eisentraut   peter_e@gmx.net

pgsql-docs by date:

Previous
From: Andrew Sullivan
Date:
Subject: Re: [PERFORM] PostgreSQL vs. MySQL
Next
From: Peter Eisentraut
Date:
Subject: Re: [HACKERS] What goes into the security doc?