Re: Inconsistencies in our SGML output

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(at)gmx(dot)net