X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org
Received: from localhost (unknown [200.46.204.2])
	by svr1.postgresql.org (Postfix) with ESMTP id 70C31D1D18D
	for <pgsql-docs-postgresql.org@localhost.postgresql.org>;
	Mon,  8 Mar 2004 23:57:30 +0000 (GMT)
Received: from svr1.postgresql.org ([200.46.204.71])
	by localhost (neptune.hub.org [200.46.204.2]) (amavisd-new, port 10024)
	with ESMTP id 53259-10
	for <pgsql-docs-postgresql.org@localhost.postgresql.org>;
	Mon,  8 Mar 2004 19:57:31 -0400 (AST)
Received: from candle.pha.pa.us (candle.pha.pa.us [207.106.42.251])
	by svr1.postgresql.org (Postfix) with ESMTP id B40BDD1C9C4
	for <pgsql-docs@postgresql.org>; Mon,  8 Mar 2004 19:57:27 -0400 (AST)
Received: (from pgman@localhost)
	by candle.pha.pa.us (8.11.6/8.11.6) id i28NvUe00822;
	Mon, 8 Mar 2004 18:57:30 -0500 (EST)
From: Bruce Momjian <pgman@candle.pha.pa.us>
Message-Id: <200403082357.i28NvUe00822@candle.pha.pa.us>
Subject: Re: [COMMITTERS] pgsql-server/doc/src/sgml Makefile
In-Reply-To: <17105.1078786012@sss.pgh.pa.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Date: Mon, 8 Mar 2004 18:57:30 -0500 (EST)
Cc: PostgreSQL-documentation <pgsql-docs@postgresql.org>,
	Peter Eisentraut <peter_e@gmx.net>
X-Mailer: ELM [version 2.4ME+ PL108 (25)]
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=US-ASCII
X-Virus-Scanned: by amavisd-new at postgresql.org
X-Archive-Number: 200403/12
X-Sequence-Number: 2302

Tom Lane wrote:
> Bruce Momjian <pgman@candle.pha.pa.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@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073