DOCS: SGML identifier may not exceed 44 characters
DOCS: SGML identifier may not exceed 44 characters
От:
Brendan Jurd <direvus@gmail.com>
Дата:
Hi folks, I was working on a little docs patch today, and when I tried to `make`, openjade choked on an identifier in information_schema.sgml, which is very much unrelated to my changes: openjade:information_schema.sgml:828:60:Q: length of name token must not exceed NAMELEN (44) Here is a trivial patch to shut openjade up. This particular id does not appear to be referred to anywhere else in the docs yet. The identifier appears to have been introduced in commit 2e2d56fea97f43cf8c40a87143bc10356e4ed4d4 on Feb 9 this year. I'm using openjade 1.3.2. Cheers, BJ diff --git a/doc/src/sgml/information_schema.sgml b/doc/src/sgml/information_schema.sgml index 2febb4c..5fdbd51 100644 --- a/doc/src/sgml/information_schema.sgml +++ b/doc/src/sgml/information_schema.sgml @@ -825,7 +825,7 @@ - + <literal>collation_character_set_applicability</literal>
Re: [HACKERS] DOCS: SGML identifier may not exceed 44 characters
От:
Alvaro Herrera <alvherre@commandprompt.com>
Дата:
Excerpts from Brendan Jurd's message of mar may 31 02:17:22 -0400 2011: > Hi folks, > > I was working on a little docs patch today, and when I tried to > `make`, openjade choked on an identifier in information_schema.sgml, > which is very much unrelated to my changes: > > 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. -- Álvaro Herrera The PostgreSQL Company - Command Prompt, Inc. PostgreSQL Replication, Consulting, Custom Development, 24x7 support
Re: [HACKERS] DOCS: SGML identifier may not exceed 44 characters
От:
Christopher Browne <cbbrowne@gmail.com>
Дата:
On Tue, May 31, 2011 at 3:22 PM, Alvaro Herrera wrote: > Excerpts from Brendan Jurd's message of mar may 31 02:17:22 -0400 2011: >> Hi folks, >> >> I was working on a little docs patch today, and when I tried to >> `make`, openjade choked on an identifier in information_schema.sgml, >> which is very much unrelated to my changes: >> >> 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. I recall hearing that this was an issue in older Red Hat and derivative distributions, and thought that it was supposed to be resolved several years ago, but perhaps there's something to undermine that belief. At any rate, I'd suggest grepping around for NAMELEN in /usr/share/sgml; you'll likely see a limitation there, in some SGML configuration file. -- When confronted by a difficult problem, solve it by reducing it to the question, "How would the Lone Ranger handle this?"
Re: [HACKERS] DOCS: SGML identifier may not exceed 44 characters
От:
Tom Lane <tgl@sss.pgh.pa.us>
Дата:
Christopher Browne writes: > On Tue, May 31, 2011 at 3:22 PM, Alvaro Herrera > 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 ... regards, tom lane
Re: [HACKERS] DOCS: SGML identifier may not exceed 44 characters
От:
Peter Eisentraut <peter_e@gmx.net>
Дата:
On tis, 2011-05-31 at 12:13 -0400, Tom Lane wrote: > Christopher Browne writes: > > On Tue, May 31, 2011 at 3:22 PM, Alvaro Herrera > > 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.
Re: [HACKERS] DOCS: SGML identifier may not exceed 44 characters
От:
Andrew Dunstan <andrew@dunslane.net>
Дата:
On 05/31/2011 04:36 PM, Peter Eisentraut wrote: > > 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. I have two buildfarm members with stock openjade/docbook installations building the docs every day. cheers andrew
Re: [HACKERS] DOCS: SGML identifier may not exceed 44 characters
От:
Brendan Jurd <direvus@gmail.com>
Дата:
On 1 June 2011 06:36, Peter Eisentraut wrote: > 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. > The relevant value on my machine seems to be: /usr/share/sgml/docbook/sgml-dtd-4.2/docbook.dcl:81: NAMELEN 44 This file belongs to the Gentoo package app-text/docbook-sgml-dtd 4.2-r2, which is the current stable version for the 4.2 slot. I would hazard to suggest that nobody else is seeing this problem because I'm the only one building the docs on Gentoo =) Still, the 44 character limit does seem to be per the upstream distribution, and the identifier I patched above is the first one to violate it. Are there any solid reasons we shouldn't just comply with it? Cheers, BJ
Re: [HACKERS] DOCS: SGML identifier may not exceed 44 characters
От:
"Albe Laurenz" <laurenz.albe@wien.gv.at>
Дата:
Peter Eisentrautwrote: >>>> 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) > > 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. I have and I encountered the same problem. I didn't bother to report it because my machine and openjade are quite old: The machine is Red Hat Enterprise Linux ES release 3 (Taroon Update 9), and docbook.dcl is from the docbook-dtds-1.0-17.2 RPM. Maybe that really only affects quite old versions, but I think it wouldn't hurt to shorten the tag in question to avoid the problem. Yours, Laurenz Albe
Re: [HACKERS] DOCS: SGML identifier may not exceed 44 characters
От:
Robert Haas <robertmhaas@gmail.com>
Дата:
On Wed, Jun 1, 2011 at 3:31 AM, Albe Laurenz wrote: > Peter Eisentrautwrote: >>>>> 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) >> >> 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. > > I have and I encountered the same problem. > I didn't bother to report it because my machine and openjade are quite old: > > The machine is Red Hat Enterprise Linux ES release 3 (Taroon Update 9), > and docbook.dcl is from the docbook-dtds-1.0-17.2 RPM. > > Maybe that really only affects quite old versions, but I think it wouldn't > hurt to shorten the tag in question to avoid the problem. +1. -- Robert Haas EnterpriseDB: http://www.enterprisedb.com The Enterprise PostgreSQL Company
Re: [HACKERS] DOCS: SGML identifier may not exceed 44 characters
От:
Andrew Dunstan <andrew@dunslane.net>
Дата:
On 06/01/2011 12:55 PM, Robert Haas wrote: > On Wed, Jun 1, 2011 at 3:31 AM, Albe Laurenz wrote: >> Peter Eisentrautwrote: >>>>>> 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) >>> 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. >> I have and I encountered the same problem. >> I didn't bother to report it because my machine and openjade are quite old: >> >> The machine is Red Hat Enterprise Linux ES release 3 (Taroon Update 9), >> and docbook.dcl is from the docbook-dtds-1.0-17.2 RPM. >> >> Maybe that really only affects quite old versions, but I think it wouldn't >> hurt to shorten the tag in question to avoid the problem. > +1. Is there no way we can ourselves override this setting if we run into it? If it's possible that seems to me like a much better way to go. cheers andrew
Re: [HACKERS] DOCS: SGML identifier may not exceed 44 characters
От:
Peter Eisentraut <peter_e@gmx.net>
Дата:
On tis, 2011-05-31 at 16:17 +1000, Brendan Jurd wrote: > Hi folks, > > I was working on a little docs patch today, and when I tried to > `make`, openjade choked on an identifier in information_schema.sgml, > which is very much unrelated to my changes: > > openjade:information_schema.sgml:828:60:Q: length of name token must > not exceed NAMELEN (44) Fixed.