Subject: Re: [HACKERS] DOCS: SGML identifier may not exceed 44
 characters
From: Peter Eisentraut <peter_e@gmx.net>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Christopher Browne <cbbrowne@gmail.com>, Alvaro Herrera
	<alvherre@commandprompt.com>, Brendan Jurd <direvus@gmail.com>, pgsql-docs
	<pgsql-docs@postgresql.org>, pgsql-hackers <pgsql-hackers@postgresql.org>
In-Reply-To: <28597.1306858415@sss.pgh.pa.us>
References: <BANLkTiktW6SRDygVfJRB4q+7dvWoQCC1Yg@mail.gmail.com>
	<1306855343-sup-2624@alvh.no-ip.org>
	<BANLkTikM2xap7F5V9rbKOukbfxGcfKcHog@mail.gmail.com>
	<28597.1306858415@sss.pgh.pa.us>
Content-Type: text/plain; charset="UTF-8"
Date: Tue, 31 May 2011 23:36:10 +0300
Message-ID: <1306874170.20912.6.camel@vanquo.pezone.net>
Mime-Version: 1.0
Content-Transfer-Encoding: 7bit

On tis, 2011-05-31 at 12:13 -0400, Tom Lane wrote:
> Christopher Browne <cbbrowne@gmail.com> writes:
> > On Tue, May 31, 2011 at 3:22 PM, Alvaro Herrera
> > <alvherre@commandprompt.com> wrote:
> >> Excerpts from Brendan Jurd's message of mar may 31 02:17:22 -0400 2011:
> >>> openjade:information_schema.sgml:828:60:Q: length of name token must
> >>> not exceed NAMELEN (44)
> 
> >> Odd. I tried it here and it doesn't fail -- same openjade version.
> >> Maybe mine is patched.
> 
> > It's not likely an issue of how OpenJade was compiled; there has been
> > a limitation in how SGML parsing was configured.  If you poke around
> > in /usr/share/sgml, you should find some configuration indicating
> > NAMELEN was set to 44.
> 
> On a Fedora 13 machine:
> 
> $ grep -r NAMELEN /usr/share/sgml/
> /usr/share/sgml/openjade-1.3.2/style-sheet.dtd:  ArcQuant CDATA #FIXED "NAMELEN 64"
> /usr/share/sgml/docbook/sgml-dtd-3.0-1.0-50.fc13/docbook.dcl:           NAMELEN    256
> /usr/share/sgml/docbook/sgml-dtd-3.0-1.0-50.fc13/cals-tbl.dtd:     NOTE:  This set of declarations assumes a NAMELEN of 32 as is used in
> /usr/share/sgml/docbook/sgml-dtd-4.4-1.0-50.fc13/docbook.dcl:           NAMELEN    256
> /usr/share/sgml/docbook/dsssl-stylesheets/dtds/dbdsssl/dbdsssl.dtd:  ArcQuant CDATA #FIXED "NAMELEN 64"
> /usr/share/sgml/docbook/dsssl-stylesheets/dtds/decls/docbook.dcl:               NAMELEN    44
> /usr/share/sgml/docbook/sgml-dtd-3.1-1.0-50.fc13/docbook.dcl:           NAMELEN    256
> /usr/share/sgml/docbook/sgml-dtd-3.1-1.0-50.fc13/cals-tbl.dtd:     NOTE:  This set of declarations assumes a NAMELEN of 32 as is used in
> /usr/share/sgml/docbook/sgml-dtd-4.1-1.0-50.fc13/docbook.dcl:           NAMELEN    256
> /usr/share/sgml/docbook/sgml-dtd-4.1-1.0-50.fc13/cals-tbl.dtd:     NOTE:  This set of declarations assumes a NAMELEN of 32 as is used in
> /usr/share/sgml/docbook/sgml-dtd-4.2-1.0-50.fc13/docbook.dcl:           NAMELEN    256
> /usr/share/sgml/docbook/sgml-dtd-4.5-1.0-50.fc13/docbook.dcl:           NAMELEN    256
> /usr/share/sgml/docbook/dsssl-stylesheets-1.79/dtds/dbdsssl/dbdsssl.dtd:  ArcQuant CDATA #FIXED "NAMELEN 64"
> /usr/share/sgml/docbook/dsssl-stylesheets-1.79/dtds/decls/docbook.dcl:          NAMELEN    44
> /usr/share/sgml/docbook/sgml-dtd-4.3-1.0-50.fc13/docbook.dcl:           NAMELEN    256
> /usr/share/sgml/docbook/sgml-dtd-4.0-1.0-50.fc13/docbook.dcl:           NAMELEN    256
> /usr/share/sgml/docbook/sgml-dtd-4.0-1.0-50.fc13/cals-tbl.dtd:     NOTE:  This set of declarations assumes a NAMELEN of 32 as is used in
> /usr/share/sgml/html.dcl:                  NAMELEN  72    -- somewhat arbitrary; taken from
> 
> It's hard to tell from this exactly which value is active in what
> contexts, but it does look like 44 is relevant in some.  FWIW,
> I don't see the reported failure on this machine ...

It looks like the original DocBook distribution has a limit of 44, but
someone patched it to 256 on your installation.

But it seems like no one else has seen this problem yet, so it's quite
suspicious, since surely people have built the documentation in the last
few months.