Re: [docbook-apps] 1.77.0 bug with index building?
Hi Bob, Thanks for the hint. This wasn't the problem (we were already looking for id or name), but it was a markup difference. We're also looking for the element with class=title and apparently this is now h1 rather than h2. Looking for both of them solved the problem. On Jun 1, 2012, at 11:17 AM, Bob Stayton wrote: One thing you might look at that changed between 1.76.1 and 1.77.0 is the effect of the 'generate.id.attributes' parameter. From the Release Notes: Generate id attributes The stylesheet param generate.id.attributes already existed but was incompletely implemented. Now when it is set to 1, only id attributes should be output, not a name named anchors. If you have set generate.id.attributes=1, then the indexterm markers placed in the text changed from: a name=it4 class=indexterm/ in 1.76.1 to a id=it4 class=indexterm/ in 1.77.0 If your script is looking for a 'name' attribute, it will no longer succeed. If you did not set that param to 1, then this suggestion would not apply because you should still get name attributes. Bob Stayton Sagehill Enterprises b...@sagehill.net - Original Message - From: Stefan Hinz stefan.h...@oracle.com To: docbook-apps@lists.oasis-open.org Sent: Friday, June 01, 2012 6:46 AM Subject: Re: [docbook-apps] 1.77.0 bug with index building? Hallo Thomas, Good catch, thanks a lot! In fact, the cannot find top string comes from one of our Perl (!) scripts that analyzes index terms to create an index navigation bar for long indexes, like the one you can see on http://dev.mysql.com/doc/refman/5.5/en/ix01.html. Not sure why the script works flawlessly with the 1.76.1 style sheets but dies with the 1.77.0 ones, but this should be fairly easy to find out. If our findings yield anything of general interest, I'll post it to this list. Of course, I'll also do so in case this still turns out to be a 1.77.0 bug. Again, thanks much for your reply, and schönes Wochenende! Cheers, Stefan On 01.06.2012 13:25, Thomas Schraitle wrote: Hi Stefan, On Fri, 01 Jun 2012 11:28:12 +0200 Stefan Hinzstefan.h...@oracle.com wrote: We're building customized XHTML output for OTN (Oracle Technology Network), for many books. Using the 1.76.1 style sheets, all works fine, but switching to the 1.77.0 style sheets gives an error like this: XML_CATALOG_FILES=../../../mysqldoc-toolset//catalog.xml ../../../mysqldoc-toolset/xsl.d/docbook-xsl-1.77.0/catalog.xml xsltproc --xinclude --novalid \ --stringparam l10n.gentext.default.language en \ --stringparam html.stylesheet mysql-html.css \ --stringparam generate.toc book toc,title \ --param chunk.section.depth 1 \ --output user.xhtml-otn-tmp/ \ ../../../mysqldoc-toolset/xsl.d/mysql-xhtml-otn.xsl \ user-prepped.xml ../../../mysqldoc-toolset/tools/add-index-navlinks.pl user.xhtml-otn-tmp/*.html Cannot find top of index 0, file user.xhtml-otn-tmp/ix01.html make: *** [user.xhtml-otn] Fehler 25 (German for error 25) I've searched for the string Cannot find top in the stylesheets and couldn't find it. I even grepped the complete SVN repository with the same result. So I guess it might be somewhere in your Makefiles or Perl scripts. To debug it further, grep/search for this string in your build mechanics. Maybe you can locate it there. Another option could be to try remake[1] instead of make. It's an improved error reporting, tracing, and a debugger for make. Frank, my colleague, uses it to debug his Makefiles. The output is a bit... challenging to read, but it could give you some important hints. Hope this helps. :) - [1] http://bashdb.sourceforge.net/remake/ -- Cheers, Stefan Hinz stefan.h...@oracle.com, MySQL Documentation Manager Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc ORACLE Deutschland B.V. Co. KG Registered Office: Riesstr. 25, 80992 Muenchen, Germany Commercial Register: Local Court Of Munich, HRA 95603 Managing Director: Jürgen Kunz General Partner: ORACLE Deutschland Verwaltung B.V. Hertogswetering 163/167, 3543 AS Utrecht, Niederlande Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697 Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h
Re: [docbook-apps] 1.77.0 bug with index building?
Right, one of the changes in 1.77 is correcting a long standing bug that put chapter titles in chunked output to h2, when they should be h1. Bob Stayton Sagehill Enterprises b...@sagehill.net - Original Message - From: Paul DuBois p...@kitebird.com To: Bob Stayton b...@sagehill.net Cc: Stefan Hinz stefan.h...@oracle.com; docbook-apps@lists.oasis-open.org Sent: Monday, June 04, 2012 8:36 AM Subject: Re: [docbook-apps] 1.77.0 bug with index building? Hi Bob, Thanks for the hint. This wasn't the problem (we were already looking for id or name), but it was a markup difference. We're also looking for the element with class=title and apparently this is now h1 rather than h2. Looking for both of them solved the problem. On Jun 1, 2012, at 11:17 AM, Bob Stayton wrote: One thing you might look at that changed between 1.76.1 and 1.77.0 is the effect of the 'generate.id.attributes' parameter. From the Release Notes: Generate id attributes The stylesheet param generate.id.attributes already existed but was incompletely implemented. Now when it is set to 1, only id attributes should be output, not a name named anchors. If you have set generate.id.attributes=1, then the indexterm markers placed in the text changed from: a name=it4 class=indexterm/ in 1.76.1 to a id=it4 class=indexterm/ in 1.77.0 If your script is looking for a 'name' attribute, it will no longer succeed. If you did not set that param to 1, then this suggestion would not apply because you should still get name attributes. Bob Stayton Sagehill Enterprises b...@sagehill.net - Original Message - From: Stefan Hinz stefan.h...@oracle.com To: docbook-apps@lists.oasis-open.org Sent: Friday, June 01, 2012 6:46 AM Subject: Re: [docbook-apps] 1.77.0 bug with index building? Hallo Thomas, Good catch, thanks a lot! In fact, the cannot find top string comes from one of our Perl (!) scripts that analyzes index terms to create an index navigation bar for long indexes, like the one you can see on http://dev.mysql.com/doc/refman/5.5/en/ix01.html. Not sure why the script works flawlessly with the 1.76.1 style sheets but dies with the 1.77.0 ones, but this should be fairly easy to find out. If our findings yield anything of general interest, I'll post it to this list. Of course, I'll also do so in case this still turns out to be a 1.77.0 bug. Again, thanks much for your reply, and schönes Wochenende! Cheers, Stefan On 01.06.2012 13:25, Thomas Schraitle wrote: Hi Stefan, On Fri, 01 Jun 2012 11:28:12 +0200 Stefan Hinzstefan.h...@oracle.com wrote: We're building customized XHTML output for OTN (Oracle Technology Network), for many books. Using the 1.76.1 style sheets, all works fine, but switching to the 1.77.0 style sheets gives an error like this: XML_CATALOG_FILES=../../../mysqldoc-toolset//catalog.xml ../../../mysqldoc-toolset/xsl.d/docbook-xsl-1.77.0/catalog.xml xsltproc --xinclude --novalid \ --stringparam l10n.gentext.default.language en \ --stringparam html.stylesheet mysql-html.css \ --stringparam generate.toc book toc,title \ --param chunk.section.depth 1 \ --output user.xhtml-otn-tmp/ \ ../../../mysqldoc-toolset/xsl.d/mysql-xhtml-otn.xsl \ user-prepped.xml ../../../mysqldoc-toolset/tools/add-index-navlinks.pl user.xhtml-otn-tmp/*.html Cannot find top of index 0, file user.xhtml-otn-tmp/ix01.html make: *** [user.xhtml-otn] Fehler 25 (German for error 25) I've searched for the string Cannot find top in the stylesheets and couldn't find it. I even grepped the complete SVN repository with the same result. So I guess it might be somewhere in your Makefiles or Perl scripts. To debug it further, grep/search for this string in your build mechanics. Maybe you can locate it there. Another option could be to try remake[1] instead of make. It's an improved error reporting, tracing, and a debugger for make. Frank, my colleague, uses it to debug his Makefiles. The output is a bit... challenging to read, but it could give you some important hints. Hope this helps. :) - [1] http://bashdb.sourceforge.net/remake/ -- Cheers, Stefan Hinz stefan.h...@oracle.com, MySQL Documentation Manager Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc ORACLE Deutschland B.V. Co. KG Registered Office: Riesstr. 25, 80992 Muenchen, Germany Commercial Register: Local Court Of Munich, HRA 95603 Managing Director: Jürgen Kunz General Partner: ORACLE Deutschland Verwaltung B.V. Hertogswetering 163/167, 3543 AS Utrecht, Niederlande Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697 Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] 1.77.0 bug with index building?
Hi Stefan, On Fri, 01 Jun 2012 11:28:12 +0200 Stefan Hinz stefan.h...@oracle.com wrote: We're building customized XHTML output for OTN (Oracle Technology Network), for many books. Using the 1.76.1 style sheets, all works fine, but switching to the 1.77.0 style sheets gives an error like this: XML_CATALOG_FILES=../../../mysqldoc-toolset//catalog.xml ../../../mysqldoc-toolset/xsl.d/docbook-xsl-1.77.0/catalog.xml xsltproc --xinclude --novalid \ --stringparam l10n.gentext.default.language en \ --stringparam html.stylesheet mysql-html.css \ --stringparam generate.toc book toc,title \ --param chunk.section.depth 1 \ --output user.xhtml-otn-tmp/ \ ../../../mysqldoc-toolset/xsl.d/mysql-xhtml-otn.xsl \ user-prepped.xml ../../../mysqldoc-toolset/tools/add-index-navlinks.pl user.xhtml-otn-tmp/*.html Cannot find top of index 0, file user.xhtml-otn-tmp/ix01.html make: *** [user.xhtml-otn] Fehler 25 (German for error 25) I've searched for the string Cannot find top in the stylesheets and couldn't find it. I even grepped the complete SVN repository with the same result. So I guess it might be somewhere in your Makefiles or Perl scripts. To debug it further, grep/search for this string in your build mechanics. Maybe you can locate it there. Another option could be to try remake[1] instead of make. It's an improved error reporting, tracing, and a debugger for make. Frank, my colleague, uses it to debug his Makefiles. The output is a bit... challenging to read, but it could give you some important hints. Hope this helps. :) - [1] http://bashdb.sourceforge.net/remake/ -- Gruß/Regards, Thomas Schraitle - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] 1.77.0 bug with index building?
Hallo Thomas, Good catch, thanks a lot! In fact, the cannot find top string comes from one of our Perl (!) scripts that analyzes index terms to create an index navigation bar for long indexes, like the one you can see on http://dev.mysql.com/doc/refman/5.5/en/ix01.html. Not sure why the script works flawlessly with the 1.76.1 style sheets but dies with the 1.77.0 ones, but this should be fairly easy to find out. If our findings yield anything of general interest, I'll post it to this list. Of course, I'll also do so in case this still turns out to be a 1.77.0 bug. Again, thanks much for your reply, and schönes Wochenende! Cheers, Stefan On 01.06.2012 13:25, Thomas Schraitle wrote: Hi Stefan, On Fri, 01 Jun 2012 11:28:12 +0200 Stefan Hinzstefan.h...@oracle.com wrote: We're building customized XHTML output for OTN (Oracle Technology Network), for many books. Using the 1.76.1 style sheets, all works fine, but switching to the 1.77.0 style sheets gives an error like this: XML_CATALOG_FILES=../../../mysqldoc-toolset//catalog.xml ../../../mysqldoc-toolset/xsl.d/docbook-xsl-1.77.0/catalog.xml xsltproc --xinclude --novalid \ --stringparam l10n.gentext.default.language en \ --stringparam html.stylesheet mysql-html.css \ --stringparam generate.toc book toc,title \ --param chunk.section.depth 1 \ --output user.xhtml-otn-tmp/ \ ../../../mysqldoc-toolset/xsl.d/mysql-xhtml-otn.xsl \ user-prepped.xml ../../../mysqldoc-toolset/tools/add-index-navlinks.pl user.xhtml-otn-tmp/*.html Cannot find top of index 0, file user.xhtml-otn-tmp/ix01.html make: *** [user.xhtml-otn] Fehler 25 (German for error 25) I've searched for the string Cannot find top in the stylesheets and couldn't find it. I even grepped the complete SVN repository with the same result. So I guess it might be somewhere in your Makefiles or Perl scripts. To debug it further, grep/search for this string in your build mechanics. Maybe you can locate it there. Another option could be to try remake[1] instead of make. It's an improved error reporting, tracing, and a debugger for make. Frank, my colleague, uses it to debug his Makefiles. The output is a bit... challenging to read, but it could give you some important hints. Hope this helps. :) - [1] http://bashdb.sourceforge.net/remake/ -- Cheers, Stefan Hinz stefan.h...@oracle.com, MySQL Documentation Manager Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc ORACLE Deutschland B.V. Co. KG Registered Office: Riesstr. 25, 80992 Muenchen, Germany Commercial Register: Local Court Of Munich, HRA 95603 Managing Director: Jürgen Kunz General Partner: ORACLE Deutschland Verwaltung B.V. Hertogswetering 163/167, 3543 AS Utrecht, Niederlande Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697 Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] 1.77.0 bug with index building?
One thing you might look at that changed between 1.76.1 and 1.77.0 is the effect of the 'generate.id.attributes' parameter. From the Release Notes: Generate id attributes The stylesheet param generate.id.attributes already existed but was incompletely implemented. Now when it is set to 1, only id attributes should be output, not a name named anchors. If you have set generate.id.attributes=1, then the indexterm markers placed in the text changed from: a name=it4 class=indexterm/ in 1.76.1 to a id=it4 class=indexterm/ in 1.77.0 If your script is looking for a 'name' attribute, it will no longer succeed. If you did not set that param to 1, then this suggestion would not apply because you should still get name attributes. Bob Stayton Sagehill Enterprises b...@sagehill.net - Original Message - From: Stefan Hinz stefan.h...@oracle.com To: docbook-apps@lists.oasis-open.org Sent: Friday, June 01, 2012 6:46 AM Subject: Re: [docbook-apps] 1.77.0 bug with index building? Hallo Thomas, Good catch, thanks a lot! In fact, the cannot find top string comes from one of our Perl (!) scripts that analyzes index terms to create an index navigation bar for long indexes, like the one you can see on http://dev.mysql.com/doc/refman/5.5/en/ix01.html. Not sure why the script works flawlessly with the 1.76.1 style sheets but dies with the 1.77.0 ones, but this should be fairly easy to find out. If our findings yield anything of general interest, I'll post it to this list. Of course, I'll also do so in case this still turns out to be a 1.77.0 bug. Again, thanks much for your reply, and schönes Wochenende! Cheers, Stefan On 01.06.2012 13:25, Thomas Schraitle wrote: Hi Stefan, On Fri, 01 Jun 2012 11:28:12 +0200 Stefan Hinzstefan.h...@oracle.com wrote: We're building customized XHTML output for OTN (Oracle Technology Network), for many books. Using the 1.76.1 style sheets, all works fine, but switching to the 1.77.0 style sheets gives an error like this: XML_CATALOG_FILES=../../../mysqldoc-toolset//catalog.xml ../../../mysqldoc-toolset/xsl.d/docbook-xsl-1.77.0/catalog.xml xsltproc --xinclude --novalid \ --stringparam l10n.gentext.default.language en \ --stringparam html.stylesheet mysql-html.css \ --stringparam generate.toc book toc,title \ --param chunk.section.depth 1 \ --output user.xhtml-otn-tmp/ \ ../../../mysqldoc-toolset/xsl.d/mysql-xhtml-otn.xsl \ user-prepped.xml ../../../mysqldoc-toolset/tools/add-index-navlinks.pl user.xhtml-otn-tmp/*.html Cannot find top of index 0, file user.xhtml-otn-tmp/ix01.html make: *** [user.xhtml-otn] Fehler 25 (German for error 25) I've searched for the string Cannot find top in the stylesheets and couldn't find it. I even grepped the complete SVN repository with the same result. So I guess it might be somewhere in your Makefiles or Perl scripts. To debug it further, grep/search for this string in your build mechanics. Maybe you can locate it there. Another option could be to try remake[1] instead of make. It's an improved error reporting, tracing, and a debugger for make. Frank, my colleague, uses it to debug his Makefiles. The output is a bit... challenging to read, but it could give you some important hints. Hope this helps. :) - [1] http://bashdb.sourceforge.net/remake/ -- Cheers, Stefan Hinz stefan.h...@oracle.com, MySQL Documentation Manager Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc ORACLE Deutschland B.V. Co. KG Registered Office: Riesstr. 25, 80992 Muenchen, Germany Commercial Register: Local Court Of Munich, HRA 95603 Managing Director: Jürgen Kunz General Partner: ORACLE Deutschland Verwaltung B.V. Hertogswetering 163/167, 3543 AS Utrecht, Niederlande Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697 Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
