Bug 906105

Summary: Intermittent failures downloading XSL from sourceforge - publican is not using the local catalog?
Product: [Community] Publican Reporter: Stephen Gordon <sgordon>
Component: publicanAssignee: Jeff Fearn <jfearn>
Status: CLOSED NOTABUG QA Contact: tools-bugs <tools-bugs>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 3.1CC: rglasz, rlandman
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2013-01-30 17:39:44 EST Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Description Stephen Gordon 2013-01-30 15:41:43 EST
Description of problem:

I have intermittently been noticing errors coming from publican when it attempts to pull the DocBook XSL from sourceforge:

$ publican build --langs=en-US --formats=html
Setting up en-US
	Processing file tmp/en-US/xml/Common_Content/Conventions.xml -> tmp/en-US/xml/Common_Content/Conventions.xml
	Processing file tmp/en-US/xml/Common_Content/Feedback.xml -> tmp/en-US/xml/Common_Content/Feedback.xml
	Processing file tmp/en-US/xml/Common_Content/Legal_Notice.xml -> tmp/en-US/xml/Common_Content/Legal_Notice.xml
	Processing file tmp/en-US/xml/Common_Content/Program_Listing.xml -> tmp/en-US/xml/Common_Content/Program_Listing.xml
	Processing file tmp/en-US/xml/Common_Content/Revision_History.xml -> tmp/en-US/xml/Common_Content/Revision_History.xml
	Processing file tmp/en-US/xml_tmp/Article_Info.xml -> tmp/en-US/xml/Article_Info.xml
	Processing file tmp/en-US/xml_tmp/Author_Group.xml -> tmp/en-US/xml/Author_Group.xml
	Processing file tmp/en-US/xml_tmp/Release_Notes.xml -> tmp/en-US/xml/Release_Notes.xml
	Processing file tmp/en-US/xml_tmp/Revision_History.xml -> tmp/en-US/xml/Revision_History.xml
Beginning work on en-US
DTD Validation OK
	Starting html
	Using XML::LibXSLT on /usr/share/publican/Common_Content/RedHat/xsl/html.xsl
http://docbook.sourceforge.net/release/xsl/current/xhtml/sections.xsl:1: parser error : Document is empty

http://docbook.sourceforge.net/release/xsl/current/xhtml/sections.xsl:1: parser error : Start tag expected, '<' not found

compilation error: file http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl line 43 element include
xsl:include : unable to load http://docbook.sourceforge.net/release/xsl/current/xhtml/sections.xsl
http://docbook.sourceforge.net/release/xsl/current/xhtml/toc.xsl:1: parser error : Document is empty


Which particular XSL files are reported as being in error varies, but it seems to result from a connectivity issue. What I am wondering is why the local DocBook catalog files aren't being used? If I retry enough times eventually all the XSL is parsed and everything works.

The /usr/share/sgml/docbook/xmlcatalog file on my system contains these entries for DocBook 4.5:

  <public publicId="-//OASIS//ELEMENTS DocBook XML Information Pool V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/dbpoolx.mod"/>
  <public publicId="-//OASIS//DTD DocBook XML V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/docbookx.dtd"/>
  <public publicId="-//OASIS//ENTITIES DocBook XML Character Entities V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/dbcentx.mod"/>
  <public publicId="-//OASIS//ENTITIES DocBook XML Notations V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/dbnotnx.mod"/>
  <public publicId="-//OASIS//ENTITIES DocBook XML Additional General Entities V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/dbgenent.mod"/>
  <public publicId="-//OASIS//ELEMENTS DocBook XML Document Hierarchy V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/dbhierx.mod"/>
  <public publicId="-//OASIS//DTD DocBook XML CALS Table Model V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/calstblx.dtd"/>
  <rewriteSystem systemIdStartString="http://www.oasis-open.org/docbook/xml/4.5" rewritePrefix="/usr/share/sgml/docbook/xml-dtd-4.5"/>
  <rewriteURI uriStartString="http://www.oasis-open.org/docbook/xml/4.5" rewritePrefix="/usr/share/sgml/docbook/xml-dtd-4.5"/>

Running publican with the XML_CATALOG_FILES=/usr/share/sgml/docbook/xmlcatalog environment variable set doesn't seem to effect things. How can I get publican to always use the local catalog? I feel like I must be missing something?

Version-Release number of selected component (if applicable):

Comment 1 Stephen Gordon 2013-01-30 15:44:15 EST
Here is the DTD entry from an impacted article:

<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
Comment 2 Jeff Fearn 2013-01-30 17:39:44 EST
Please ask this kind of support question on the list before opening bugs. It's almost impossible for this to be a publican specific issue.