diff options
| author | Mats Wichmann <mats@linux.com> | 2020-04-16 17:16:37 (GMT) |
|---|---|---|
| committer | Mats Wichmann <mats@linux.com> | 2020-04-16 17:29:58 (GMT) |
| commit | 9ec99deef3afe9d6230b29cc87cfc5ecc9916186 (patch) | |
| tree | f5764e8ee93d91b5931d428726346e1896d42074 /doc/man/html.xsl | |
| parent | 880c0e09434c3e7e71b6a72db9d0e9b367f9fda5 (diff) | |
| download | SCons-9ec99deef3afe9d6230b29cc87cfc5ecc9916186.zip SCons-9ec99deef3afe9d6230b29cc87cfc5ecc9916186.tar.gz SCons-9ec99deef3afe9d6230b29cc87cfc5ecc9916186.tar.bz2 | |
Update generation of scons-xml entities [ci skip]
PR #3602 introduced a new problem - the documents that include
the generated functions and builders files now don't validate.
The global function/environment method name was bolded by
using <emphasis>, but Docbook doesn't allow that inside a
<literal> element (it actually works fine with the processing
tools we use, but does fail validation).
Rework the idea: use <function> and <methodname> for the markup,
and change the way those are rendered in html (man/html.xsl and
user/html.xsl) - the PDF already rendered these in bold so no
change needed there. Also don't wrap the whole contents of the
<term> element in <literal>, which would have left the argument
list in regular font which the function name and instance
name in monospace - an odd look. So the argument list was
wrapped in <parameter>, since that's what they are. Don't
bother to try to parse it down into individual args, just do
the whole chunk, less the parentheses.
Signed-off-by: Mats Wichmann <mats@linux.com>
Diffstat (limited to 'doc/man/html.xsl')
| -rw-r--r-- | doc/man/html.xsl | 8 |
1 files changed, 7 insertions, 1 deletions
diff --git a/doc/man/html.xsl b/doc/man/html.xsl index 00cc782..d4f33da 100644 --- a/doc/man/html.xsl +++ b/doc/man/html.xsl @@ -28,7 +28,7 @@ xmlns:fo="http://www.w3.org/1999/XSL/Format" version="1.0"> - <xsl:import href="../../src/engine/SCons/Tool/docbook/docbook-xsl-1.76.1/html/docbook.xsl"/> +<xsl:import href="../../src/engine/SCons/Tool/docbook/docbook-xsl-1.76.1/html/docbook.xsl"/> <xsl:param name="l10n.gentext.default.language" select="'en'"/> <xsl:param name="section.autolabel" select="1"/> @@ -54,6 +54,12 @@ reference title set toc,title </xsl:param> +<xsl:template match="function"> + <xsl:call-template name="inline.boldmonoseq"/> +</xsl:template> +<xsl:template match="methodname"> + <xsl:call-template name="inline.boldmonoseq"/> +</xsl:template> <!-- Prevent our EPUB cover image from getting included --> <xsl:template match="mediaobject[@role = 'cover']"> </xsl:template> |