From: | Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us> |
---|---|
To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>, Peter Eisentraut <peter_e(at)gmx(dot)net> |
Subject: | Re: [COMMITTERS] pgsql-server/doc/src/sgml Makefile |
Date: | 2004-03-08 23:57:30 |
Message-ID: | 200403082357.i28NvUe00822@candle.pha.pa.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-committers pgsql-docs |
Tom Lane wrote:
> Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us> writes:
> > I wonder if the cause is my version of the sgml tools, rather than lynx.
>
> > What do you see in your HISTORY.htlm file for "Migration":
>
> > ><DIV
> > CLASS="SECT2"
> > ><HR><H3
> > CLASS="SECT2"
> > ><A
> > NAME="AEN9"
> > >Migration to version 7.4.2</A
>
> Hmm, I get
>
> ><DIV
> CLASS="SECT2"
> ><HR><H2
> CLASS="SECT2"
> ><A
> NAME="AEN9"
> >Migration to version 7.4.2</A
> ></H2
>
> so the discrepancy is evidently <H2> vs <H3>. In my HISTORY.html,
> "Release Notes" and "Release 7.4.2" are both <H1> and then the
> Migration heading is <H2>.
>
> So indeed it looks like the discrepancy is in the SGML stylesheet.
> I'm not real sure whether the <H3> interpretation should be preferred
> --- Peter, any comments?
Looking at the SGML, it seems the H3 interpretation is correct. SGML
has:
<appendix id="release">
<title>Release Notes</title>
<sect1 id="release-7-4-2">
<title>Release 7.4.2</title>
<note>
<title>Release date</title>
<simpara>2004-03-08</simpara>
</note>
<para>
This release contains a variety of fixes from 7.4.1.
</para>
<sect2>
<title>Migration to version 7.4.2</title>
Appendix/release should be H1, release-7-4-2 should be H2, and migration
H3. I don't see any logic for appendix and sect1 be the same HTML
heading level because they don't seem to be the same level in SGML.
--
Bruce Momjian | http://candle.pha.pa.us
pgman(at)candle(dot)pha(dot)pa(dot)us | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
From | Date | Subject | |
---|---|---|---|
Next Message | Bruce Momjian | 2004-03-08 23:59:24 | pgsql-server/doc/src/sgml Makefile |
Previous Message | Tom Lane | 2004-03-08 22:46:52 | Re: [COMMITTERS] pgsql-server/doc/src/sgml Makefile |
From | Date | Subject | |
---|---|---|---|
Next Message | Bruce Momjian | 2004-03-09 05:05:18 | Re: "ALSO" keyword to "CREATE RULE" patch |
Previous Message | Tom Lane | 2004-03-08 22:46:52 | Re: [COMMITTERS] pgsql-server/doc/src/sgml Makefile |