In trying to get the docs building in HEAD I found one of the reasons
why doc builds fail for me. There's this bit of code in
tools/boostbook/xsl/chunk-common.xsl:
<!-- ====================================================================
<xsl:template match="*" mode="recursive-chunk-filename">
<xsl:param name="recursive" select="false()"/>
<xsl:variable name="their">
<xsl:apply-imports mode="recursive-chunk-filename" select="."/>
</xsl:variable>
<xsl:variable name="basename" select="substring-before( $their,
$html.ext )"/>
<xsl:choose>
<xsl:when test="not($recursive)">
<xsl:value-of select="translate( $basename, '.', '/' )"/>
<xsl:value-of select="$html.ext"/>
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="$basename"/>
<xsl:value-of select="'.'"/>
</xsl:otherwise>
</xsl:choose>
</xsl:template>
==================================================================== -->
And what does that do? It takes the default output file names of the
form "boost.xpressive.regex_compiler.html" and turns them into
"boost/xpressive/regex_compiler.html". Which seems like a reasonable
thing to do. Except for the part where stylesheets are *not* allowed to
create directories, they can only create files. This transformation
happens to work for some people because of a bug in earlier versions of
the xslt libraries. For recent versions the library spits out a long
series of errors instead of creating the subdirs.
You'll note that above the code looks commented out. That's because,
that was my temporary, local, fix :-) I've been trying to figure out how
to "fix" this problem and nothing useful, i.e. that doesn't violate our
file name rules, comes to mind.
--
-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. - http://redshift-software.com
-- rrivera/acm.org - grafik/redshift-software.com
-- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo
-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys-and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
