Skip site navigation (1) Skip section navigation (2)

Re: [COMMITTERS] pgsql-server/doc/src/sgml Makefile

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 (view raw or flat)
Thread:
Lists: pgsql-committerspgsql-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

In response to

pgsql-docs by date

Next:From: Bruce MomjianDate: 2004-03-09 05:05:18
Subject: Re: "ALSO" keyword to "CREATE RULE" patch
Previous:From: Tom LaneDate: 2004-03-08 22:46:52
Subject: Re: [COMMITTERS] pgsql-server/doc/src/sgml Makefile

pgsql-committers by date

Next:From: Bruce MomjianDate: 2004-03-08 23:59:24
Subject: pgsql-server/doc/src/sgml Makefile
Previous:From: Tom LaneDate: 2004-03-08 22:46:52
Subject: Re: [COMMITTERS] pgsql-server/doc/src/sgml Makefile

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group