Bug 113080

Summary: KDE docbook dtd not in system xml catalog
Product: [openSUSE] SUSE Linux 10.1 Reporter: Chris Lahey <clahey>
Component: KDEAssignee: Karl Eichwalder <ke>
Status: RESOLVED WORKSFORME QA Contact: E-mail List <qa-bugs>
Severity: Enhancement    
Priority: P5 - None CC: thomas.schraitle
Version: unspecified   
Target Milestone: Alpha 2   
Hardware: All   
OS: All   
Whiteboard:
Found By: Development Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---

Description Chris Lahey 2005-08-25 16:47:13 UTC 
kdelibs3-doc installs
/opt/kde3/share/apps/ksgmltools2/docbook/xml-dtd-4.2/docbookx.dtd , but this
file isn't registered in the system xml catalog (/etc/xml/catalog).

This means that non KDE xml parsers are unable to parse the documentation
provided by KDE apps.  The system xml catalog is the standard way for xml
parsers to find DTDs referenced by xml files.
Comment 1 Dirk Mueller 2005-09-07 07:17:39 UTC 
is there a script/macro to register them in a postinstall hook or similiar?
Comment 2 Stephan Kulow 2005-09-07 09:09:35 UTC 
Karl, can you please help out here? Note that the file the bug report refers 
to is just a copy of the docbook DTD, which we can easily symlink (not for 
10.0 though). But kdelibs3-doc still installs other catalog files not 
registered (.../customization/catalog)
Comment 3 Stephan Kulow 2005-09-07 09:23:37 UTC 
stupid web interface. Karl, please look above
Comment 4 Karl Eichwalder 2005-09-07 14:20:18 UTC 
docbookx.dtd version 4.2 also comes with docbook_4.  With docbook_4 installed
arbitrary DTD aware parsers are able to validate KDE documentation.  The report
looks invalid to me.
Comment 5 Stephan Kulow 2005-09-07 14:27:14 UTC 
as I said in #2, the report itself is bogus, yes.  
 
But KDE docbook looks like this: 
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" 
"dtd/kdex.dtd"
Comment 6 Chris Lahey 2005-09-07 14:50:01 UTC 
Could you explain how the report is invalid?

The problem isn't that there is no dtd installed that will allow the document to
be parsed.  The problem is that there's no way for a standard parser to find the
dtd based on the doctype declaration as quoted above.  dtd/kdex.dtd isn't a
proper uri, so we can't search based on that.  The standard way to turn the
string "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" into a DTD is to
look in /etc/xml/catalog, but it's not in there anywhere.

How is an arbitrary xml parser supposed to find the DTD?
Comment 7 Karl Eichwalder 2005-09-08 09:37:47 UTC 
Okay, dtd/kdex.dtd is a different story.
Comment 8 Karl Eichwalder 2005-09-08 09:38:16 UTC 
I will write a recipe.
Comment 9 Karl Eichwalder 2005-09-08 09:39:07 UTC 
for 10.1 - I hope that's okay with you.
Comment 10 Karl Eichwalder 2005-09-18 03:34:23 UTC 
see comment #7 and comment #8
Comment 11 Karl Eichwalder 2005-09-21 21:06:11 UTC 
-------------------------------------------------------------------
Wed Sep 21 23:01:32 CEST 2005 - ke@suse.de

- Add KDE docbook customizations to the SGML resp. XML catalog system [#
  113080].

-------------------------------------------------------------------

untested.
Comment 12 Karl Eichwalder 2005-10-06 07:39:09 UTC 
Also check SGML catalog and make use of toms converter script.
Comment 13 Karl Eichwalder 2005-10-17 12:33:04 UTC 
Issue was already fixed with the patch applied on 2005-09-21.  In case of trouble, please reopen and provide a test case.