|
From: <sv...@va...> - 2005-11-27 04:10:06
|
Author: de
Date: 2005-11-27 04:10:00 +0000 (Sun, 27 Nov 2005)
New Revision: 5239
Log:
Post-release changes:
- removed a reference to cachegrind dot org from mc-tech-docs.xml
- in an effort to simplify future borked links, replaced all valgrind=20
website urls with entities so now we just have to change one string.
- new stylesheet to create the docs to 'fit' into the website
- added build rules 'make website-docs' + make download-docs
to /docs/Makefile.am
Added:
trunk/docs/lib/vg-html-website.xsl
Modified:
trunk/docs/Makefile.am
trunk/docs/lib/Makefile.am
trunk/docs/lib/vg-fo.xsl
trunk/docs/lib/vg-html-chunk.xsl
trunk/docs/xml/FAQ.xml
trunk/docs/xml/dist-docs.xml
trunk/docs/xml/index.xml
trunk/docs/xml/licenses.xml
trunk/docs/xml/manual-core.xml
trunk/docs/xml/manual-intro.xml
trunk/docs/xml/manual.xml
trunk/docs/xml/quick-start-guide.xml
trunk/docs/xml/vg-entities.xml
trunk/docs/xml/writing-tools.xml
Modified: trunk/docs/Makefile.am
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/Makefile.am 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/Makefile.am 2005-11-27 04:10:00 UTC (rev 5239)
@@ -31,6 +31,11 @@
myhtmldir =3D $(top_builddir)/docs/html
myprintdir =3D $(top_builddir)/docs/print
=20
+websitedir =3D $(top_builddir)/docs/website
+valkyriedir =3D $(top_builddir)/docs/vg-html
+downloadsdir =3D $(top_builddir)/docs/downloads
+vgdir =3D $(top_builddir)/docs/valgrind
+
XML_CATALOG_FILES =3D /etc/xml/catalog
=20
# file to log print output to
@@ -50,6 +55,7 @@
XSL_HTML_CHUNK_STYLE =3D $(mylibdir)/vg-html-chunk.xsl
XSL_FO_STYLE =3D $(mylibdir)/vg-fo.xsl
XSL_TEXT_STYLE =3D $(mylibdir)/vg-faq2txt.xsl
+XSL_WEBSITE_STYLE =3D $(mylibdir)/vg-html-website.xsl
=20
all-docs: FAQ.txt html-docs print-docs
=20
@@ -115,7 +121,6 @@
fi
endif
=20
-
# This is done at 'make dist' time. It builds the html and print docs
# and copies them into the docs/ directory in the tarball.
ifeq ($(BUILD_ALL_DOCS),yes)
@@ -133,3 +138,63 @@
distclean-local:
rm -rf html print
rm -f $(top_builddir)/FAQ.txt
+
+
+
+# Note: the following three rules are nothing to do with the normal buil=
d tree.
+
+# chunked html with no html/body tags, css, or top nav, to fit into the =
website
+website-docs:
+ @echo "Generating website html files ..."
+ export XML_CATALOG_FILES=3D$(XML_CATALOG_FILES)
+ /bin/rm -fr $(websitedir)
+ mkdir -p $(websitedir)
+ $(XSLTPROC) $(XSLTPROC_FLAGS) -o $(websitedir)/ $(XSL_WEBSITE_STYLE) $(=
myxmldir)/index.xml
+
+# valkyrie carries around her own copy of the valgrind manual
+valkyrie-docs:
+ @echo "Generating a set of valgrind docs for valkyrie..."
+ export XML_CATALOG_FILES=3D$(XML_CATALOG_FILES)
+ /bin/rm -fr $(valkyriedir)
+ mkdir -p $(valkyriedir)
+ mkdir -p $(valkyriedir)/images
+ cp $(mylibdir)/vg_basic.css $(valkyriedir)/
+ cp $(myimgdir)/*.png $(valkyriedir)/images/
+ $(XSLTPROC) $(XSLTPROC_FLAGS) -o $(valkyriedir)/ $(XSL_HTML_CHUNK_STYLE=
) $(myxmldir)/index.xml
+
+# html.tar.bz2, .pdf, .ps.bz2 files for downloading from the website
+download-docs:
+ export XML_CATALOG_FILES=3D$(XML_CATALOG_FILES)
+ /bin/rm -fr $(downloadsdir)
+ mkdir -p $(downloadsdir)
+ @echo ""
+ @echo "Generating valgrind_manual.html.tar.bz2 ..."
+ export XML_CATALOG_FILES=3D$(XML_CATALOG_FILES)
+ /bin/rm -fr $(vgdir)
+ mkdir -p $(vgdir)
+ mkdir -p $(vgdir)/html
+ mkdir -p $(vgdir)/html/images
+ cp $(mylibdir)/vg_basic.css $(vgdir)/html/
+ cp $(myimgdir)/*.png $(vgdir)/html/images/
+ $(XSLTPROC) $(XSLTPROC_FLAGS) -o $(vgdir)/html/ $(XSL_HTML_CHUNK_STYLE)=
$(myxmldir)/index.xml
+ (cd $(top_builddir)/docs/ && \
+ (tar cfj $(downloadsdir)/valgrind_manual.html.tar.bz2 ./valgrind/html/=
) )
+ /bin/rm -fr $(vgdir)/html/
+ @echo ""
+ @echo "Generating valgrind_manual.pdf ..."
+ mkdir -p $(vgdir)/print
+ mkdir -p $(vgdir)/print/images
+ cp $(myimgdir)/massif-graph-sm.png $(vgdir)/print/images/
+ $(XSLTPROC) $(XSLTPROC_FLAGS) -o $(vgdir)/print/manual.fo $(XSL_FO_STYL=
E) $(myxmldir)/index.xml
+ (cd $(vgdir)/print/ && \
+ ( pdfxmltex manual.fo && \
+ pdfxmltex manual.fo && \
+ pdfxmltex manual.fo ) &> $(LOGFILE) < /dev/null )
+ @echo ""
+ @echo "Generating valgrind_manual.ps.bz2 ..."
+ (cd $(vgdir)/print/ && \
+ ( pdftops manual.pdf ) )
+ mv $(vgdir)/print/manual.pdf $(downloadsdir)/valgrind_manual.pdf
+ mv $(vgdir)/print/manual.ps $(downloadsdir)/valgrind_manual.ps
+ bzip2 $(downloadsdir)/valgrind_manual.ps
+ /bin/rm -fr $(vgdir)
Modified: trunk/docs/lib/Makefile.am
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/lib/Makefile.am 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/lib/Makefile.am 2005-11-27 04:10:00 UTC (rev 5239)
@@ -1,6 +1,7 @@
-EXTRA_DIST =3D \
- vg-fo.xsl \
- vg-html-chunk.xsl \
- vg-faq2txt.xsl \
- line-wrap.xsl \
- vg_basic.css
+EXTRA_DIST =3D \
+ vg-fo.xsl \
+ vg-html-chunk.xsl \
+ vg-faq2txt.xsl \
+ line-wrap.xsl \
+ vg_basic.css \
+ vg-html-website.xsl
Modified: trunk/docs/lib/vg-fo.xsl
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/lib/vg-fo.xsl 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/lib/vg-fo.xsl 2005-11-27 04:10:00 UTC (rev 5239)
@@ -41,10 +41,12 @@
qandaset toc
</xsl:param>
=20
-<!-- properties common to html + fo -->
+<!-- properties common to html + fo ................................... =
-->
+
<!-- we like '1.2 Title' -->
<xsl:param name=3D"section.autolabel" select=3D"'1'"/>=20
<xsl:param name=3D"section.label.includes.component.label" select=3D"'1'=
"/>
+
<!-- Do not put 'Chapter' at the start of eg 'Chapter 1. Doing This' -->
<xsl:param name=3D"local.l10n.xml" select=3D"document('')"/>=20
<l:i18n xmlns:l=3D"http://docbook.sourceforge.net/xmlns/l10n/1.0">=20
@@ -55,7 +57,16 @@
</l:l10n>
</l:i18n>
=20
+<!-- per Bob Stayton: turn off xml:base processing pro tem -->
+<!-- should hopefully be fixed in next docbook stylesheets release (1.70=
) -->
+<!-- ensures correct source paths, eg. images/my_img.png -->
+<xsl:template match=3D"@fileref">
+ <xsl:value-of select=3D"."/>
+</xsl:template>
=20
+<!-- end properties common to html + fo ............................... =
-->
+
+
<!-- Bug-fix for Suse 10 PassiveTex version -->
<!-- Precompute attribute values 'cos PassiveTex is too stupid: -->
<xsl:attribute-set name=3D"component.title.properties">
@@ -74,13 +85,6 @@
<xsl:attribute name=3D"hyphenate">false</xsl:attribute>
</xsl:attribute-set>
=20
-<!-- per Bob Stayton: turn off xml:base processing pro tem -->
-<!-- should hopefully be fixed in next docbook stylesheets release (1.70=
) -->
-<!-- ensures correct source paths, eg. images/my_img.png -->
-<xsl:template match=3D"@fileref">
- <xsl:value-of select=3D"."/>
-</xsl:template>
-
<!-- show links in color -->
<xsl:attribute-set name=3D"xref.properties">
<xsl:attribute name=3D"color">blue</xsl:attribute>
Modified: trunk/docs/lib/vg-html-chunk.xsl
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/lib/vg-html-chunk.xsl 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/lib/vg-html-chunk.xsl 2005-11-27 04:10:00 UTC (rev 5239)
@@ -38,7 +38,8 @@
</xsl:param>
=20
=20
-<!-- properties common to html + fo -->
+<!-- properties common to html + fo ................................... =
-->
+
<!-- we like '1.2 Title' -->
<xsl:param name=3D"section.autolabel" select=3D"'1'"/>=20
<xsl:param name=3D"section.label.includes.component.label" select=3D"'1'=
"/>
@@ -59,14 +60,42 @@
<xsl:value-of select=3D"."/>
</xsl:template>
=20
+<!-- end properties common to html + fo ............................... =
-->
=20
+
<!-- center everything at the top of a titlepage -->
<xsl:attribute-set name=3D"set.titlepage.recto.style">
<xsl:attribute name=3D"align">center</xsl:attribute>
</xsl:attribute-set>
=20
=20
-<!-- use our custom header -->
+<!-- don`t put an expanded set-level TOC, only book titles -->
+<xsl:template match=3D"book" mode=3D"toc">
+ <xsl:param name=3D"toc-context" select=3D"."/>
+ <xsl:choose>
+ <xsl:when test=3D"local-name($toc-context) =3D 'set'">
+ <xsl:call-template name=3D"subtoc">
+ <xsl:with-param name=3D"toc-context" select=3D"$toc-context"/>
+ <xsl:with-param name=3D"nodes" select=3D"foo"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:call-template name=3D"subtoc">
+ <xsl:with-param name=3D"toc-context" select=3D"$toc-context"/>
+ <xsl:with-param name=3D"nodes" select=3D"part|reference
+ |preface|chapter|appendix
+ |article
+ |bibliography|glossary|index
+ |refentry
+ |bridgehead[$bridgehead.in.toc =
!=3D
+0]"/>
+ </xsl:call-template>
+ </xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
+
+<!-- custom header for html docs -->
<xsl:template name=3D"header.navigation">
<xsl:param name=3D"prev" select=3D"/foo"/>
<xsl:param name=3D"next" select=3D"/foo"/>
@@ -148,16 +177,6 @@
<!-- chapter|section heading -->
<th align=3D"center" valign=3D"middle">
<xsl:apply-templates select=3D"$up" mode=3D"object.title.markup"/=
>
-<!--
- <xsl:choose>
- <xsl:when test=3D"count($up) > 0 and generate-id($up) !=3D genera=
te-id($home)">
- <xsl:apply-templates select=3D"$up" mode=3D"object.title.markup"=
/>
- </xsl:when>
- <xsl:otherwise>
- <xsl:text>Valgrind User`s Manual</xsl:text>
- </xsl:otherwise>
- </xsl:choose>
--->
</th>
<!-- next -->
<td width=3D"22px" align=3D"center" valign=3D"middle">
@@ -187,7 +206,7 @@
</xsl:template>
=20
=20
-<!-- our custom footer -->
+<!-- custom footer -->
<xsl:template name=3D"footer.navigation">
<xsl:param name=3D"prev" select=3D"/foo"/>
<xsl:param name=3D"next" select=3D"/foo"/>
@@ -299,52 +318,8 @@
</div>
</xsl:template>
=20
-<!-- We don`t like tables with borders -->
-<xsl:template match=3D"revhistory" mode=3D"titlepage.mode">
- <xsl:variable name=3D"numcols">
- <xsl:choose>
- <xsl:when test=3D"//authorinitials">3</xsl:when>
- <xsl:otherwise>2</xsl:otherwise>
- </xsl:choose>
- </xsl:variable>
- <table width=3D"100%" border=3D"0" summary=3D"Revision history">
- <tr>
- <th align=3D"left" colspan=3D"{$numcols}">
- <h3>Revision History</h3>
- </th>
- </tr>
- <xsl:apply-templates mode=3D"titlepage.mode">
- <xsl:with-param name=3D"numcols" select=3D"$numcols"/>
- </xsl:apply-templates>
- </table>
-</xsl:template>
=20
-<!-- don`t put an expanded set-level TOC, only book titles -->
-<xsl:template match=3D"book" mode=3D"toc">
- <xsl:param name=3D"toc-context" select=3D"."/>
- <xsl:choose>
- <xsl:when test=3D"local-name($toc-context) =3D 'set'">
- <xsl:call-template name=3D"subtoc">
- <xsl:with-param name=3D"toc-context" select=3D"$toc-context"/>
- <xsl:with-param name=3D"nodes" select=3D"foo"/>
- </xsl:call-template>
- </xsl:when>
- <xsl:otherwise>
- <xsl:call-template name=3D"subtoc">
- <xsl:with-param name=3D"toc-context" select=3D"$toc-context"/>
- <xsl:with-param name=3D"nodes" select=3D"part|reference
- |preface|chapter|appendix
- |article
- |bibliography|glossary|index
- |refentry
- |bridgehead[$bridgehead.in.toc =
!=3D
-0]"/>
- </xsl:call-template>
- </xsl:otherwise>
- </xsl:choose>
-</xsl:template>
-
-<!-- question and answer set mods -->
+<!-- faq styles -->
<xsl:template match=3D"answer">
<xsl:variable name=3D"deflabel">
<xsl:choose>
Added: trunk/docs/lib/vg-html-website.xsl
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/lib/vg-html-website.xsl (rev 0)
+++ trunk/docs/lib/vg-html-website.xsl 2005-11-27 04:10:00 UTC (rev 5239)
@@ -0,0 +1,433 @@
+<?xml version=3D"1.0"?> <!-- -*- sgml -*- -->
+<xsl:stylesheet xmlns:xsl=3D"http://www.w3.org/1999/XSL/Transform" versi=
on=3D"1.0">
+
+<xsl:import href=3D"http://docbook.sourceforge.net/release/xsl/current/h=
tml/docbook.xsl"/>
+<xsl:import href=3D"http://docbook.sourceforge.net/release/xsl/current/h=
tml/chunk-common.xsl"/>
+<xsl:import href=3D"http://docbook.sourceforge.net/release/xsl/current/h=
tml/manifest.xsl"/>
+<xsl:import href=3D"http://docbook.sourceforge.net/release/xsl/current/h=
tml/chunk-code.xsl"/>
+
+<!-- special stylesheet to generate the docs to fit into the website =
-->
+<!-- the only differences between this and vg-html-chunk.xsl should be: =
-->
+<!-- (a) no css stylesheet is used; -->
+<!-- (b) no navigation header is used; -->
+<!-- (c) no html start/end tags are output -->
+
+
+<!-- use 8859-1 encoding -->
+<xsl:output method=3D"html" encoding=3D"ISO-8859-1" indent=3D"yes"/>
+
+<!-- set various parameters -->
+<xsl:param name=3D"use.id.as.filename" select=3D"'1'"/>=20
+<xsl:param name=3D"chunker.output.indent" select=3D"'yes'"/>
+<!-- set chunking at the chapter level only -->
+<xsl:param name=3D"chunk.section.depth" select=3D"'0'"/>=20
+<!-- do not generate sub-tocs for qanda sets -->
+<xsl:param name=3D"generate.toc">
+set toc,title
+book toc,title,figure,table,example,equation
+chapter toc,title
+section toc
+sect1 toc
+sect2 toc
+sect3 toc
+sect4 nop
+sect5 nop
+qandaset toc
+qandadiv toc
+appendix toc,title
+article/appendix nop
+article nop
+preface toc,title
+reference toc,title
+</xsl:param>
+
+<!-- properties common to html + fo ................................... =
-->
+
+<!-- we like '1.2 Title' -->
+<xsl:param name=3D"section.autolabel" select=3D"'1'"/>=20
+<xsl:param name=3D"section.label.includes.component.label" select=3D"'1'=
"/>
+
+<!-- Do not put 'Chapter' at the start of eg 'Chapter 1. Doing This' -->
+<xsl:param name=3D"local.l10n.xml" select=3D"document('')"/>=20
+<l:i18n xmlns:l=3D"http://docbook.sourceforge.net/xmlns/l10n/1.0">=20
+ <l:l10n language=3D"en">=20
+ <l:context name=3D"title-numbered">
+ <l:template name=3D"chapter" text=3D"%n. %t"/>
+ </l:context>=20
+ </l:l10n>
+</l:i18n>
+
+<!-- per Bob Stayton: turn off xml:base processing pro tem -->
+<!-- should hopefully be fixed in next docbook stylesheets release (1.70=
) -->
+<xsl:template match=3D"@fileref">
+ <xsl:value-of select=3D"."/>
+</xsl:template>
+
+<!-- end properties common to html + fo ............................... =
-->
+
+
+<!-- center everything at the top of a titlepage -->
+<xsl:attribute-set name=3D"set.titlepage.recto.style">
+ <xsl:attribute name=3D"align">center</xsl:attribute>
+</xsl:attribute-set>
+
+
+<!-- don`t put an expanded set-level TOC, only book titles -->
+<xsl:template match=3D"book" mode=3D"toc">
+ <xsl:param name=3D"toc-context" select=3D"."/>
+ <xsl:choose>
+ <xsl:when test=3D"local-name($toc-context) =3D 'set'">
+ <xsl:call-template name=3D"subtoc">
+ <xsl:with-param name=3D"toc-context" select=3D"$toc-context"/>
+ <xsl:with-param name=3D"nodes" select=3D"foo"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:call-template name=3D"subtoc">
+ <xsl:with-param name=3D"toc-context" select=3D"$toc-context"/>
+ <xsl:with-param name=3D"nodes"=20
+ select=3D"part|reference|preface|chapter|appendi=
x
+ |article|bibliography|glossary|index
+ |refentry|bridgehead[$bridgehead.in.toc =
!=3D 0]"/>
+ </xsl:call-template>
+ </xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
+
+<!-- custom header for website: no 'html' / 'body' etc. tags -->
+<xsl:template name=3D"chunk-element-content">
+ <xsl:param name=3D"prev"/>
+ <xsl:param name=3D"next"/>
+ <xsl:param name=3D"nav.context"/>
+ <xsl:param name=3D"content">
+ <xsl:apply-imports/>
+ </xsl:param>
+ <xsl:copy-of select=3D"$content"/>
+ <xsl:call-template name=3D"footer.navigation">
+ <xsl:with-param name=3D"prev" select=3D"$prev"/>
+ <xsl:with-param name=3D"next" select=3D"$next"/>
+ <xsl:with-param name=3D"nav.context" select=3D"$nav.context"/>
+ </xsl:call-template>
+</xsl:template>
+
+
+<!-- custom footer -->
+<xsl:template name=3D"footer.navigation">
+ <xsl:param name=3D"prev" select=3D"/foo"/>
+ <xsl:param name=3D"next" select=3D"/foo"/>
+ <xsl:param name=3D"nav.context"/>
+
+ <xsl:variable name=3D"home" select=3D"/*[1]"/>
+ <xsl:variable name=3D"up" select=3D"parent::*"/>
+
+ <xsl:variable name=3D"row1" select=3D"count($prev) > 0
+ or count($up) > 0
+ or count($next) > 0"/>
+
+ <xsl:variable name=3D"row2" select=3D"($prev !=3D 0)
+ or (generate-id($home) !=3D generate-id(.) or $nav.context =
=3D 'toc')
+ or ($chunk.tocs.and.lots !=3D 0 and $nav.context !=3D 'toc'=
)
+ or ($next !=3D 0)"/>
+ <div>
+ <xsl:if test=3D"$row1 or $row2">
+ <br />
+ <table class=3D"nav" width=3D"100%" cellspacing=3D"3" cellpadding=3D"=
2" border=3D"0" summary=3D"Navigation footer">
+ <xsl:if test=3D"$row1">
+ <tr>
+ <td rowspan=3D"2" width=3D"40%" align=3D"left">
+ <xsl:if test=3D"count($prev)>0">
+ <a accesskey=3D"p">
+ <xsl:attribute name=3D"href">
+ <xsl:call-template name=3D"href.target">
+ <xsl:with-param name=3D"object" select=3D"$prev"/>
+ </xsl:call-template>
+ </xsl:attribute>
+ <xsl:text><< </xsl:text>
+ <xsl:apply-templates select=3D"$prev" mode=3D"object.title.mark=
up"/>
+ </a>
+ </xsl:if>
+ <xsl:text> </xsl:text>
+ </td>
+ <td width=3D"20%" align=3D"center">
+ <xsl:choose>
+ <xsl:when test=3D"count($up)>0">
+ <a accesskey=3D"u">
+ <xsl:attribute name=3D"href">
+ <xsl:call-template name=3D"href.target">
+ <xsl:with-param name=3D"object" select=3D"$up"/>
+ </xsl:call-template>
+ </xsl:attribute>
+ <xsl:call-template name=3D"navig.content">
+ <xsl:with-param name=3D"direction" select=3D"'up'"/>
+ </xsl:call-template>
+ </a>
+ </xsl:when>
+ <xsl:otherwise> </xsl:otherwise>
+ </xsl:choose>
+ </td>
+ <td rowspan=3D"2" width=3D"40%" align=3D"right">
+ <xsl:text> </xsl:text>
+ <xsl:if test=3D"count($next)>0">
+ <a accesskey=3D"n">
+ <xsl:attribute name=3D"href">
+ <xsl:call-template name=3D"href.target">
+ <xsl:with-param name=3D"object" select=3D"$next"/>
+ </xsl:call-template>
+ </xsl:attribute>
+ <xsl:apply-templates select=3D"$next" mode=3D"object.title.mark=
up"/>
+ <xsl:text> >></xsl:text>
+ </a>
+ </xsl:if>
+ </td>
+ </tr>
+ </xsl:if>
+ <xsl:if test=3D"$row2">
+ <tr>
+ <td width=3D"20%" align=3D"center">
+ <xsl:choose>
+ <xsl:when test=3D"$home !=3D . or $nav.context =3D 'toc'">
+ <a accesskey=3D"h">
+ <xsl:attribute name=3D"href">
+ <xsl:call-template name=3D"href.target">
+ <xsl:with-param name=3D"object" select=3D"$home"/>
+ </xsl:call-template>
+ </xsl:attribute>
+ <xsl:call-template name=3D"navig.content">
+ <xsl:with-param name=3D"direction" select=3D"'home'"/>
+ </xsl:call-template>
+ </a>
+ <xsl:if test=3D"$chunk.tocs.and.lots !=3D 0 and $nav.context !=3D=
'toc'">
+ <xsl:text> | </xsl:text>
+ </xsl:if>
+ </xsl:when>
+ <xsl:otherwise> </xsl:otherwise>
+ </xsl:choose>
+ <xsl:if test=3D"$chunk.tocs.and.lots !=3D 0 and $nav.context !=3D=
'toc'">
+ <a accesskey=3D"t">
+ <xsl:attribute name=3D"href">
+ <xsl:apply-templates select=3D"/*[1]" mode=3D"recursive-chunk-=
filename"/>
+ <xsl:text>-toc</xsl:text>
+ <xsl:value-of select=3D"$html.ext"/>
+ </xsl:attribute>
+ <xsl:call-template name=3D"gentext">
+ <xsl:with-param name=3D"key" select=3D"'nav-toc'"/>
+ </xsl:call-template>
+ </a>
+ </xsl:if>
+ </td>
+ </tr>
+ </xsl:if>
+ </table>
+ </xsl:if>
+ </div>
+</xsl:template>
+
+
+<!-- qandaset styles -->
+<!-- these templates have been carefully tweaked to correct the horrible=
-->
+<!-- mess that docbook makes of dl/dt/dd tags. Edit with care. =
-->
+<xsl:template match=3D"qandaset">
+ <xsl:variable name=3D"title" select=3D"(blockinfo/title|title)[1]"/>
+ <xsl:variable name=3D"toc">
+ <xsl:call-template name=3D"dbhtml-attribute">
+ <xsl:with-param name=3D"pis" select=3D"processing-instruction('dbh=
tml')"/>
+ <xsl:with-param name=3D"attribute" select=3D"'toc'"/>
+ </xsl:call-template>
+ </xsl:variable>
+
+ <xsl:variable name=3D"toc.params">
+ <xsl:call-template name=3D"find.path.params">
+ <xsl:with-param name=3D"table" select=3D"normalize-space($generate=
.toc)"/>
+ </xsl:call-template>
+ </xsl:variable>
+
+ <div class=3D"{name(.)}">
+ <xsl:apply-templates select=3D"$title"/>
+ <xsl:if test=3D"(contains($toc.params, 'toc') and $toc !=3D '0') or =
$toc =3D '1'">
+ <xsl:call-template name=3D"process.qanda.toc"/>
+ </xsl:if>
+ <xsl:apply-templates select=3D"qandaentry|qandadiv"/>
+ </div>
+</xsl:template>
+
+
+<xsl:template match=3D"qandadiv">
+<!--
+ <hr/>
+-->
+ <br/>
+ <table width=3D"100%" summary=3D"Q and A Div" cellpadding=3D"2" cellsp=
acing=3D"2" border=3D"0">
+ <xsl:if test=3D"blockinfo/title|title">
+ <tr class=3D"qandadiv">
+ <td align=3D"left" valign=3D"top" colspan=3D"2">
+ <xsl:call-template name=3D"anchor">
+ <xsl:with-param name=3D"conditional" select=3D"0"/>
+ </xsl:call-template>
+ <xsl:apply-templates select=3D"(blockinfo/title|title)[1]"/>
+ </td>
+ </tr>
+ </xsl:if>
+
+ <xsl:variable name=3D"toc">
+ <xsl:call-template name=3D"dbhtml-attribute">
+ <xsl:with-param name=3D"pis"
+ select=3D"processing-instruction('dbhtml')"/>
+ <xsl:with-param name=3D"attribute" select=3D"'toc'"/>
+ </xsl:call-template>
+ </xsl:variable>
+
+ <xsl:variable name=3D"toc.params">
+ <xsl:call-template name=3D"find.path.params">
+ <xsl:with-param name=3D"table" select=3D"normalize-space($generate=
.toc)"/>
+ </xsl:call-template>
+ </xsl:variable>
+
+ <xsl:if test=3D"(contains($toc.params, 'toc') and $toc !=3D '0') or $t=
oc =3D '1'">
+ <tr class=3D"toc" colspan=3D"2">
+ <td align=3D"left" valign=3D"top" colspan=3D"2">
+ <xsl:call-template name=3D"process.myqanda.toc"/>
+ </td>
+ </tr>
+ </xsl:if>
+ <xsl:apply-templates select=3D"qandadiv|qandaentry"/>
+ </table>
+</xsl:template>
+
+
+<!-- put questions in bold -->
+<xsl:template match=3D"question/para">
+ <b><xsl:apply-templates/></b>
+</xsl:template>
+
+<xsl:template match=3D"question">
+ <xsl:variable name=3D"deflabel">
+ <xsl:choose>
+ <xsl:when test=3D"ancestor-or-self::*[@defaultlabel]">
+ <xsl:value-of select=3D"(ancestor-or-self::*[@defaultlabel])[las=
t()]
+ /@defaultlabel"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select=3D"$qanda.defaultlabel"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <tr><td colspan=3D"2"><xsl:text> </xsl:text></td></tr>
+ <tr class=3D"{name(.)}">
+ <td align=3D"left" valign=3D"top">
+ <xsl:call-template name=3D"anchor">
+ <xsl:with-param name=3D"node" select=3D".."/>
+ <xsl:with-param name=3D"conditional" select=3D"0"/>
+ </xsl:call-template>
+ <xsl:call-template name=3D"anchor">
+ <xsl:with-param name=3D"conditional" select=3D"0"/>
+ </xsl:call-template>
+ <b>
+ <xsl:apply-templates select=3D"." mode=3D"label.markup"/>
+ <xsl:if test=3D"$deflabel =3D 'number' and not(label)">
+ <xsl:apply-templates select=3D"." mode=3D"intralabel.punctuati=
on"/>
+ </xsl:if>
+ </b>
+ </td>
+ <td align=3D"left" valign=3D"top">
+ <xsl:choose>
+ <xsl:when test=3D"$deflabel =3D 'none' and not(label)">
+ <b><xsl:apply-templates select=3D"*[name(.) !=3D 'label']"/></=
b>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:apply-templates select=3D"*[name(.) !=3D 'label']"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </td>
+ </tr>
+</xsl:template>
+
+
+<xsl:template name=3D"process.myqanda.toc">
+ <xsl:apply-templates select=3D"qandadiv" mode=3D"qandatoc.mode"/>
+ <xsl:apply-templates select=3D"qandaentry" mode=3D"myqandatoc.mode"/>
+</xsl:template>
+
+
+<xsl:template name=3D"process.qanda.toc">
+ <xsl:apply-templates select=3D"qandadiv" mode=3D"qandatoc.mode"/>
+ <xsl:apply-templates select=3D"qandaentry" mode=3D"qandatoc.mode"/>
+</xsl:template>
+
+
+<xsl:template match=3D"qandadiv" mode=3D"qandatoc.mode">
+<dl>
+ <dt><xsl:apply-templates select=3D"title" mode=3D"qandatoc.mode"/></dt=
>
+ <xsl:call-template name=3D"process.qanda.toc"/>
+</dl>
+</xsl:template>
+
+
+<!-- this one is used at the top of the page -->
+<xsl:template match=3D"question" mode=3D"qandatoc.mode">
+ <xsl:variable name=3D"firstch" select=3D"(*[name(.)!=3D'label'])[1]"/>
+ <xsl:variable name=3D"deflabel">
+ <xsl:choose>
+ <xsl:when test=3D"ancestor-or-self::*[@defaultlabel]">
+ <xsl:value-of select=3D"(ancestor-or-self::*[@defaultlabel])[las=
t()]
+ /@defaultlabel"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select=3D"$qanda.defaultlabel"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <dd>
+ <xsl:apply-templates select=3D"." mode=3D"label.markup"/>
+ <xsl:if test=3D"$deflabel =3D 'number' and not(label)">
+ <xsl:apply-templates select=3D"." mode=3D"intralabel.punctuation"/=
>
+ </xsl:if>
+ <xsl:text> </xsl:text>
+ <a>
+ <xsl:attribute name=3D"href">
+ <xsl:call-template name=3D"href.target">
+ <xsl:with-param name=3D"object" select=3D".."/>
+ </xsl:call-template>
+ </xsl:attribute>
+ <xsl:value-of select=3D"$firstch"/>
+ </a>
+ </dd>
+</xsl:template>
+
+
+<!-- this one is used within table cells -->
+<xsl:template match=3D"qandaentry" mode=3D"myqandatoc.mode">
+ <xsl:apply-templates select=3D"question" mode=3D"myqandatoc.mode"/>
+</xsl:template>
+
+<xsl:template match=3D"question" mode=3D"myqandatoc.mode">
+ <xsl:variable name=3D"firstch" select=3D"(*[name(.)!=3D'label'])[1]"/>
+ <xsl:variable name=3D"deflabel">
+ <xsl:choose>
+ <xsl:when test=3D"ancestor-or-self::*[@defaultlabel]">
+ <xsl:value-of select=3D"(ancestor-or-self::*[@defaultlabel])[las=
t()]
+ /@defaultlabel"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select=3D"$qanda.defaultlabel"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:apply-templates select=3D"." mode=3D"label.markup"/>
+ <xsl:if test=3D"$deflabel =3D 'number' and not(label)">
+ <xsl:apply-templates select=3D"." mode=3D"intralabel.punctuation"/=
>
+ </xsl:if>
+ <xsl:text> </xsl:text>
+ <a>
+ <xsl:attribute name=3D"href">
+ <xsl:call-template name=3D"href.target">
+ <xsl:with-param name=3D"object" select=3D".."/>
+ </xsl:call-template>
+ </xsl:attribute>
+ <xsl:value-of select=3D"$firstch"/>
+ </a>
+ <br />
+</xsl:template>
+
+
+</xsl:stylesheet>
Modified: trunk/docs/xml/FAQ.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/xml/FAQ.xml 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/xml/FAQ.xml 2005-11-27 04:10:00 UTC (rev 5239)
@@ -3,6 +3,7 @@
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
[ <!ENTITY % vg-entities SYSTEM "vg-entities.xml"> %vg-entities; ]>
=20
+
<book id=3D"FAQ" xreflabel=3D"Valgrind FAQ">
=20
<bookinfo>
@@ -18,7 +19,7 @@
</bookinfo>
=20
=20
-<article>
+<article id=3D"faq">
<title>Valgrind Frequently Asked Questions</title>
=20
=20
@@ -523,11 +524,9 @@
<para>If you think an answer is incomplete or inaccurate, please
e-mail <ulink url=3D"mailto:&vg-vemail;">&vg-vemail;</ulink>.</para>
=20
- <para>Read the appropriate section(s) of the=20
- <ulink url=3D"http://www.valgrind.org/docs/manual.html">Valgrind=20
- Documentation</ulink>.</para>
+ <para>Read the appropriate section(s) of the <xref linkend=3D"set-inde=
x"/>.</para>
=20
- <para>Read the <ulink url=3D"http://www.valgrind.org/docs/dist.html">D=
istribution Documents</ulink>.</para>
+ <para>Read the <xref linkend=3D"dist"/>.</para>
=20
<para><ulink url=3D"http://search.gmane.org">Search</ulink> the=20
<ulink url=3D"http://news.gmane.org/gmane.comp.debugging.valgrind">val=
grind-users</ulink> mailing list archives, using the group name=20
Modified: trunk/docs/xml/dist-docs.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/xml/dist-docs.xml 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/xml/dist-docs.xml 2005-11-27 04:10:00 UTC (rev 5239)
@@ -3,6 +3,7 @@
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
[ <!ENTITY % vg-entities SYSTEM "vg-entities.xml"> %vg-entities; ]>
=20
+
<book id=3D"dist" xreflabel=3D"Distribution Documents">
=20
<bookinfo>
@@ -17,8 +18,8 @@
</author>
</bookinfo>
=20
- <!-- Nb: because these are all text files, we have to wrap them in sui=
table
- XML. Hence the chapter/title stuff -->
+ <!-- Nb: because these are all text files, we have to wrap -->
+ <!-- them in suitable XML. Hence the chapter/title stuff -->
=20
<chapter id=3D"dist.acknowledge" xreflabel=3D"Acknowledgements">
<title>ACKNOWLEDGEMENTS</title>
Modified: trunk/docs/xml/index.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/xml/index.xml 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/xml/index.xml 2005-11-27 04:10:00 UTC (rev 5239)
@@ -1,13 +1,11 @@
<?xml version=3D"1.0"?> <!-- -*- sgml -*- -->
<!DOCTYPE set PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
-[
- <!-- various strings, dates etc. common to all docs -->
- <!ENTITY % vg-entities SYSTEM "vg-entities.xml"> %vg-entities;
-]>
+[ <!ENTITY % vg-entities SYSTEM "vg-entities.xml"> %vg-entities; ]>
=20
-<set id=3D"index" lang=3D"en">
=20
+<set lang=3D"en" id=3D"set-index" xreflabel=3D"Valgrind Documentation">
+
<setinfo>
<title>Valgrind Documentation</title>
<releaseinfo>&rel-type; &rel-version; &rel-date;</releaseinfo>
@@ -19,13 +17,12 @@
</copyright>
=20
<legalnotice>
- <para>Permission is granted to copy, distribute and/or
- modify this document under the terms of the GNU Free
- Documentation License, Version 1.2 or any later version
- published by the Free Software Foundation; with no
- Invariant Sections, with no Front-Cover Texts, and with no
- Back-Cover Texts. A copy of the license is included in the
- section entitled <xref linkend=3D"license.gfdl"/>.</para>
+ <para>Permission is granted to copy, distribute and/or=20
+ modify this document under the terms of the GNU Free Documentation=
License,
+ Version 1.2 or any later version published by the Free Software Fo=
undation;=20
+ with no Invariant Sections, with no Front-Cover Texts, and with no=
Back-Cover
+ Texts. A copy of the license is included in the section entitled=20
+ <xref linkend=3D"license.gfdl"/>.</para>
</legalnotice>
=20
</setinfo>
Modified: trunk/docs/xml/licenses.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/xml/licenses.xml 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/xml/licenses.xml 2005-11-27 04:10:00 UTC (rev 5239)
@@ -11,8 +11,7 @@
<chapter id=3D"license.gpl" xreflabel=3D" The GNU General Public Licen=
se">
<title>The GNU General Public License</title>
<literallayout>
- <xi:include href=3D"../../COPYING"=20
- parse=3D"text" =20
+ <xi:include href=3D"../../COPYING" parse=3D"text" =20
xmlns:xi=3D"http://www.w3.org/2001/XInclude" />
</literallayout>
</chapter>
@@ -20,8 +19,7 @@
<chapter id=3D"license.gfdl" xreflabel=3D"The GNU Free Documentation L=
icense">
<title>The GNU Free Documentation License</title>
<literallayout>
- <xi:include href=3D"../../COPYING.DOCS"=20
- parse=3D"text" =20
+ <xi:include href=3D"../../COPYING.DOCS" parse=3D"text" =20
xmlns:xi=3D"http://www.w3.org/2001/XInclude" />
</literallayout>
</chapter>
Modified: trunk/docs/xml/manual-core.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/xml/manual-core.xml 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/xml/manual-core.xml 2005-11-27 04:10:00 UTC (rev 5239)
@@ -1,7 +1,9 @@
<?xml version=3D"1.0"?> <!-- -*- sgml -*- -->
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
+[ <!ENTITY % vg-entities SYSTEM "vg-entities.xml"> %vg-entities; ]>
=20
+
<chapter id=3D"manual-core" xreflabel=3D"Valgrind's core">
<title>Using and understanding the Valgrind core</title>
=20
@@ -1558,7 +1560,7 @@
<sect1 id=3D"manual-core.problems" xreflabel=3D"If You Have Problems">
<title>If You Have Problems</title>
=20
-<para>Contact us at <ulink url=3D"http://www.valgrind.org">http://www.va=
lgrind.org</ulink>.</para>
+<para>Contact us at <ulink url=3D"&vg-url;">&vg-url;</ulink>.</para>
=20
<para>See <xref linkend=3D"manual-core.limits"/> for the known
limitations of Valgrind, and for a list of programs which are
@@ -1577,9 +1579,8 @@
effect before dying in this way. This is a known problem which
we should fix.</para>
=20
-<para>Read the=20
-<ulink url=3D"http://www.valgrind.org/docs/FAQ/">FAQ</ulink> for
-more advice about common problems, crashes, etc.</para>
+<para>Read the <xref linkend=3D"FAQ"/> for more advice about common prob=
lems,=20
+crashes, etc.</para>
=20
</sect1>
=20
Modified: trunk/docs/xml/manual-intro.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/xml/manual-intro.xml 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/xml/manual-intro.xml 2005-11-27 04:10:00 UTC (rev 5239)
@@ -114,7 +114,7 @@
=20
<para>Cachegrind is nicely complemented by Josef
Weidendorfer's amazing KCacheGrind visualisation tool=20
- (<ulink url=3D"http://kcachegrind.sourceforge.net">http://kcachegrin=
d.sourceforge.net</ulink>),
+ (<ulink url=3D"http://kcachegrind.sourceforge.net/cgi-bin/show.cgi/K=
cacheGrindIndex">http://kcachegrind.sourceforge.net</ulink>),
a KDE application which presents these profiling results in a
graphical and easier-to-understand form.</para>
</listitem>
Modified: trunk/docs/xml/manual.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/xml/manual.xml 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/xml/manual.xml 2005-11-27 04:10:00 UTC (rev 5239)
@@ -29,7 +29,7 @@
<xi:include href=3D"../../cachegrind/docs/cg-manual.xml" parse=3D"xml"=
=20
xmlns:xi=3D"http://www.w3.org/2001/XInclude" />
<xi:include href=3D"../../massif/docs/ms-manual.xml" parse=3D"xml" =20
- xmlns:xi=3D"http://www.w3.org/2001/XInclude" />
+ xmlns:xi=3D"http://www.w3.org/2001/XInclude" />
<xi:include href=3D"../../helgrind/docs/hg-manual.xml" parse=3D"xml" =20
xmlns:xi=3D"http://www.w3.org/2001/XInclude" />
<xi:include href=3D"../../none/docs/nl-manual.xml" parse=3D"xml" =20
Modified: trunk/docs/xml/quick-start-guide.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/xml/quick-start-guide.xml 2005-11-26 16:27:42 UTC (rev 523=
8)
+++ trunk/docs/xml/quick-start-guide.xml 2005-11-27 04:10:00 UTC (rev 523=
9)
@@ -3,7 +3,7 @@
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
[ <!ENTITY % vg-entities SYSTEM "vg-entities.xml"> %vg-entities; ]>
=20
-<book id=3D"quick-start" xreflabel=3D"Valgrind Quick Start Guide">
+<book id=3D"QuickStart" xreflabel=3D"Valgrind Quick Start Guide">
=20
<bookinfo>
<title>The Valgrind Quick Start Guide</title>
@@ -18,7 +18,7 @@
</bookinfo>
=20
=20
-<article>
+<article id=3D"quick-start">
<title>The Valgrind Quick Start Guide</title>
=20
=20
Modified: trunk/docs/xml/vg-entities.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/xml/vg-entities.xml 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/xml/vg-entities.xml 2005-11-27 04:10:00 UTC (rev 5239)
@@ -1,13 +1,18 @@
<!-- misc. strings -->
-<!ENTITY vg-url "http://www.valgrind.org">
-<!ENTITY vg-jemail "ju...@va...">
-<!ENTITY vg-vemail "val...@va...">
-<!ENTITY vg-lifespan "2000-2005">
+<!ENTITY vg-url "http://www.valgrind.org/">
+<!ENTITY vg-jemail "ju...@va...">
+<!ENTITY vg-vemail "val...@va...">
+<!ENTITY vg-lifespan "2000-2005">
<!ENTITY vg-users-list "http://lists.sourceforge.net/lists/listinfo/valg=
rind-users">
<!ENTITY vg-developers "http://www.valgrind.org/info/developers.html">
+<!ENTITY vg-svn-repo "http://www.valgrind.org/downloads/repository.htm=
l">
=20
+
<!-- valgrind release + version stuff -->
<!ENTITY rel-type "Release">
<!ENTITY rel-version "3.1.0">
<!ENTITY rel-date "November 25 2005">
=20
+<!-- valgrind website links used in lots of places in the docs -->
+<!-- kept in here 'cos everytime the website gets changed, it`s -->
+<!-- a real pain tracking the links down in the docs -->
Modified: trunk/docs/xml/writing-tools.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/xml/writing-tools.xml 2005-11-26 16:27:42 UTC (rev 5238)
+++ trunk/docs/xml/writing-tools.xml 2005-11-27 04:10:00 UTC (rev 5239)
@@ -1,8 +1,7 @@
<?xml version=3D"1.0"?> <!-- -*- sgml -*- -->
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"[
-<!ENTITY % vg-entities SYSTEM "../../docs/xml/vg-entities.xml"> %vg-enti=
ties;
-]>
+ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
+[ <!ENTITY % vg-entities SYSTEM "vg-entities.xml"> %vg-entities; ]>
=20
<chapter id=3D"writing-tools" xreflabel=3D"Writing a New Valgrind Tool">
<title>Writing a New Valgrind Tool</title>
@@ -302,9 +301,8 @@
<para>To write your own tool, you'll need the Valgrind source code.
A normal source distribution should do, although you might want to
check out the latest code from the Subversion repository. See the
-information about how to do so at
-<ulink url=3D"http://www.valgrind.org/downloads/repository.html">the
-Valgrind website</ulink>.</para>
+information about how to do so at=20
+<ulink url=3D"&vg-svn-repo;">the Valgrind website</ulink>.</para>
=20
</sect2>
=20
@@ -761,7 +759,7 @@
<para>If you aren't confident using XML, or you have problems
with the toolchain, then write your documentation in text format,
email it to
-<computeroutput>val...@va...</computeroutput>, and
+<computeroutput>&vg-vemail;</computeroutput>, and
someone will convert it to XML for you. Otherwise, follow these
steps (using <computeroutput>foobar</computeroutput> as the
example tool name again):</para>
@@ -862,7 +860,7 @@
]]></programlisting>
=20
<para>Send a patch for this to
- <computeroutput>val...@va...</computeroutput>.</para>
+ <computeroutput>&vg-vemail;</computeroutput>.</para>
=20
<para>To achieve true anality, try for a full doc-set build:</para>
<screen><![CDATA[
|