diff options
| author | Matthew Burgess <matthew@linuxfromscratch.org> | 2013-10-08 20:03:29 +0000 |
|---|---|---|
| committer | Matthew Burgess <matthew@linuxfromscratch.org> | 2013-10-08 20:03:29 +0000 |
| commit | 15c7d39533a1eb1da0748011f3378fd0f02ed14d (patch) | |
| tree | a7ed12df60c5ffd4d00a570804c51470bfb8b0f5 /stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/generate.consistent.ids.xml | |
| parent | 09a35dd7178070f01a7961d2ded39e11ba2aac83 (diff) | |
Update stylesheets to docbook-xsl-1.78.1.
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@10355 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/generate.consistent.ids.xml')
| -rw-r--r-- | stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/generate.consistent.ids.xml | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/generate.consistent.ids.xml b/stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/generate.consistent.ids.xml new file mode 100644 index 000000000..249cb8c46 --- /dev/null +++ b/stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/generate.consistent.ids.xml @@ -0,0 +1,53 @@ +<refentry xmlns="http://docbook.org/ns/docbook" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns:xi="http://www.w3.org/2001/XInclude" + xmlns:src="http://nwalsh.com/xmlns/litprog/fragment" + xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="5.0" xml:id="generate.consistent.ids"> +<refmeta> +<refentrytitle>generate.consistent.ids</refentrytitle> +<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> +</refmeta> +<refnamediv> +<refname>generate.consistent.ids</refname> +<refpurpose>Generate consistent id values if document is unchanged</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<src:fragment xml:id="generate.consistent.ids.frag"> +<xsl:param name="generate.consistent.ids" select="0"/> +</src:fragment> +</refsynopsisdiv> + +<refsection><info><title>Description</title></info> + +<para>When the stylesheet assigns an id value to an output element, +the generate-id() function may be used. That function may not +produce consistent values between runs. Version control +systems may misidentify the changing id values as changes +to the document.</para> + +<para>If you set this parameter's value to 1, then the +template named <literal>object.id</literal> will replace +the use of the function generate-id() with +<literal><xsl:number level="multiple" count="*"/></literal>. +This counts preceding elements to generate a unique number for +the id value.</para> + +<caution> +<para>This param does not associate permanent unique id values +with particular elements. +The id values are consistent only as long as the document +structure does not change. +If the document structure changes, then the counting +of elements changes, and all id values after +the first such change may be different, even when there is +no change to the element itself or its output. +</para> +</caution> + +<para>The default value of this parameter is zero, so generate-id() is used +by default.</para> + +</refsection> +</refentry> |