Saxon Documentation

Full Contents

About Saxon

Changes in this Release

Licensing

Using XSLT 2.0

Using XQuery

Handling Source Documents

XML Schema Processing

XPath API for Java

Saxon on .NET

Extensibility

Saxon Extensions

Sample Saxon Applications

The Saxon SQL Extension

XSLT Elements
	Introduction
	xsl:analyze-string
	xsl:apply-imports
	xsl:apply-templates
	xsl:attribute
	xsl:attribute-set
	xsl:call-template
	xsl:character-map
	xsl:choose
»	xsl:comment
	xsl:copy
	xsl:copy-of
	xsl:decimal-format
	xsl:document
	xsl:element
	xsl:fallback
	xsl:for-each
	xsl:for-each-group
	xsl:function
	xsl:if
	xsl:include
	xsl:import
	xsl:import-schema
	xsl:key
	xsl:matching-substring
	xsl:message
	xsl:namespace
	xsl:namespace-alias
	xsl:next-match
	xsl:non-matching-substring
	xsl:number
	xsl:otherwise
	xsl:output
	xsl:output-character
	xsl:param
	xsl:perform-sort
	xsl:preserve-space
	xsl:processing-instruction
	xsl:result-document
	xsl:sequence
	xsl:sort
	xsl:strip-space
	xsl:stylesheet
	xsl:template
	xsl:text
	xsl:value-of
	xsl:variable
	xsl:when
	xsl:with-param
	Literal Result Elements
	XSLT Patterns

XPath 2.0 Expression Syntax

Function Library

Standards Conformance

xsl:comment

The xsl:comment element can appear anywhere within an xsl:template. It indicates text that is to be output to the current output stream in the form of an XML or HTML comment.

The content of the comment may be given either by a select attribute or by an enclosed sequence constructor. If the select attribute is used and the value is a sequence, then the items in the sequence are output space-separated.

For example, the text below inserts some JavaScript into a generated HTML document:

<script language="JavaScript">
    <xsl:comment>
        function bk(n) {
            parent.frames['content'].location="chap" + n + ".1.html";
        }
    //</xsl:comment>
</script>

Note that special characters occurring within the comment text will not be escaped.

The xsl:comment element will normally contain text only but it may contain other elements such as xsl:if or xsl:value-of. However, it should not contain literal result elements.

Tip: the xsl:comment element can be very useful for debugging your stylesheet. Use comments in the generated output as a way of tracking which rules in the stylesheet were invoked to produce the output.