{"thread":{"id":"24504","subject":"[PATCH] INSTALL: Add instructions about configuring /etc/xml/catalog on Cygwin for documentation builds.","startedAt":"2010-07-25T03:57:35Z","lastAt":"2010-07-25T03:57:35Z","messageCount":1,"participants":["Jon Seymour"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"146242","messageId":"1280030255-4764-1-git-send-email-jon.seymour@gmail.com","threadId":"24504","inReplyTo":null,"subject":"[PATCH] INSTALL: Add instructions about configuring /etc/xml/catalog on Cygwin for documentation builds.","fromName":"Jon Seymour","fromEmail":"jon.seymour@gmail.com","sentAt":"2010-07-25T03:57:35Z","receivedAt":"2010-07-25T03:57:35Z","isPatch":true,"sender":{"key":"jon.seymour@gmail.com","avatar":"https://avatars.githubusercontent.com/u/207131?v=4"},"body":"Without additional configuration steps, the documentation build on Cygwin fails because the XML catalog is missing required rewrites for certain docbook resources.\n\nThis patch documents the required configuration.\n\nSigned-off-by: Jon Seymour <jon.seymour@gmail.com>\n---\n INSTALL |   33 +++++++++++++++++++++++++++++++++\n 1 files changed, 33 insertions(+), 0 deletions(-)\n\ndiff --git a/INSTALL b/INSTALL\nindex 61086ab..59200b7 100644\n--- a/INSTALL\n+++ b/INSTALL\n@@ -157,3 +157,36 @@ Issues of note:\n    It has been reported that docbook-xsl version 1.72 and 1.73 are\n    buggy; 1.72 misformats manual pages for callouts, and 1.73 needs\n    the patch in contrib/patches/docbook-xsl-manpages-charmap.patch\n+\n+   Users attempting to build the documentation on Cygwin may need to ensure\n+   that the /etc/xml/catalog file looks something like this:\n+\n+   <?xml version=\"1.0\"?>\n+   <!DOCTYPE catalog PUBLIC\n+      \"-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN\"\n+      \"http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd\"\n+   >\n+   <catalog xmlns=\"urn:oasis:names:tc:entity:xmlns:xml:catalog\">\n+     <rewriteURI\n+       uriStartString = \"http://docbook.sourceforge.net/release/xsl/current\"\n+       rewritePrefix = \"/usr/share/sgml/docbook/xsl-stylesheets\"\n+     />\n+     <rewriteURI\n+       uriStartString=\"http://www.oasis-open.org/docbook/xml/4.5\"\n+       rewritePrefix=\"/usr/share/sgml/docbook/xml-dtd-4.5\"\n+     />\n+  </catalog>\n+\n+  This can be achieved with the following two xmlcatalog commands:\n+\n+  xmlcatalog --noout \\\n+     --add rewriteURI \\\n+        http://docbook.sourceforge.net/release/xsl/current \\\n+        /usr/share/sgml/docbook/xsl-stylesheets \\\n+     /etc/xml/catalog\n+\n+  xmlcatalog --noout \\\n+     --add rewriteURI \\\n+         http://www.oasis-open.org/docbook/xml/4.5/xsl/current \\\n+         /usr/share/sgml/docbook/xml-dtd-4.5 \\\n+     /etc/xml/catalog\n-- \n1.7.0.4.6.ge3842\n"}]}