[xml/sgml-commit] r699 - packages/docbook2x/trunk/debian

[Daniel Leidert]

Author: dleidert-guest
Date: 2007-04-10 20:54:39 +0000 (Tue, 10 Apr 2007)
New Revision: 699

Added:
   packages/docbook2x/trunk/debian/TODO
Log:
* debian/TODO: Added.


Added: packages/docbook2x/trunk/debian/TODO
===================================================================
--- packages/docbook2x/trunk/debian/TODO	2007-04-10 20:46:10 UTC (rev 698)
+++ packages/docbook2x/trunk/debian/TODO	2007-04-10 20:54:39 UTC (rev 699)
@@ -0,0 +1,23 @@
+Things that should (IMHO definitely) be done in the near future:
+
+  * make the package XML policy compliant.
+
+    - move the stylesheets into /usr/share/xml
+    - register the catalog
+
+  * solve the conflict with the docbook-utils package binaries
+    (including: man-pages and docs currently use the names chosen by upstream,
+    not "our" tranformed binary names)
+
+  * the man-pages contain references to files in /usr/share
+    [.. citing Steve Cheng ..] So you have two choices:
+
+    1. You can either use a sed script afterwards to fix the paths in the
+    installed man pages (and HTML, Texinfo documentation).
+
+    2. Or, force the rebuild of the documentation at your end.
+    After running the configure --with-html-xsl, touch doc/docbook2X.xml and
+    then make.  (Note: don't use VPATH builds in this situation; it breaks.)
+    Of course you will need the xsltproc and the DocBook XSL stylesheets for
+    this procedure. [..]
+