Re: [Boost-docs] boost-root/doc/test needed

Subject: Re: [Boost-docs] boost-root/doc/test needed
From: Eric Niebler (eric_at_[hidden])
Date: 2008-07-29 18:58:19

Eric Niebler wrote:
> There is a simple test case attached to 
> http://svn.boost.org/trac/boost/ticket/1584. It is about the most 
> trivial use of BoostBook, QuickBook and Doxygen imaginable. With this 
> little test, I can reproduce Beman's problem (or some problem) with the 
> Windows tool chain. Oddly, it works under cygwin.
> 
> Looks like Doxygen is correctly emitting XML, but that our collect.xsl 
> transform is failing to do anything meaningful with it. I'm looking into 
> it.

It looks like the windows version of xsltproc is not recognizing the 
windows paths to external xml files. <sigh> The good news is that the 
external files we're referring to are always in the same directory as 
the xml file we're currently processing, so we can do away with the 
absolute path and use a relative path instead.

Beman, can you apply this patch to your 
tools/boostbook/xsl/doxygen/collect.xsl and see if it fixes your 
problem? I've tested this with my windows and cygwin toolchains. If 
someone could test on Linux, that'd be groovy.

-- 
Eric Niebler
BoostPro Computing
http://www.boostpro.com

Index: collect.xsl
===================================================================
--- collect.xsl	(revision 47856)
+++ collect.xsl	(working copy)
@@ -9,8 +9,6 @@
 <xsl:stylesheet        xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
   <xsl:output method="xml" version="1.0" indent="yes" standalone="yes" />
  
-  <xsl:param name="doxygen.xml.path">./</xsl:param>
- 
   <xsl:template match="/">
     <doxygen>
       <xsl:attribute name="version">
@@ -37,8 +35,7 @@
           </xsl:choose>
         </xsl:variable>
         <xsl:if test="$id">
-          <xsl:copy-of select="document( concat($doxygen.xml.path, '/',
-                               $id, '.xml' ) )/doxygen/*" />
+          <xsl:copy-of select="document( concat( $id, '.xml' ), / )/doxygen/*" />
         </xsl:if>
       </xsl:for-each>
       <xsl:for-each select="doxygenindex/compound">
@@ -53,8 +50,7 @@
           </xsl:choose>
         </xsl:variable>
         <xsl:if test="$id">
-          <xsl:copy-of select="document( concat($doxygen.xml.path, '/',
-                               $id, '.xml' ) )/doxygen/*" />
+          <xsl:copy-of select="document( concat($id, '.xml'), /)/doxygen/*" />
         </xsl:if>
       </xsl:for-each>
     </doxygen>