]> git.stg.codes - stg.git/blob - doc/xslt/params/refentry.version.profile.xml
Use ptrdiff_t type for length variable to prevent comparsion signed and
[stg.git] / doc / xslt / params / refentry.version.profile.xml
1 <refentry xmlns="http://docbook.org/ns/docbook"
2           xmlns:xlink="http://www.w3.org/1999/xlink"
3           xmlns:xi="http://www.w3.org/2001/XInclude"
4           xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
5           xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
6           version="5.0" xml:id="refentry.version.profile">
7 <refmeta>
8 <refentrytitle>refentry.version.profile</refentrytitle>
9 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
10 </refmeta>
11 <refnamediv>
12 <refname>refentry.version.profile</refname>
13 <refpurpose>Specifies profile for refentry "version" data</refpurpose>
14 </refnamediv>
15
16 <refsynopsisdiv>
17 <src:fragment xml:id="refentry.version.profile.frag">
18 <xsl:param name="refentry.version.profile">
19   (($info[//productnumber])[last()]/productnumber)[1]|
20   (($info[//edition])[last()]/edition)[1]|
21   (($info[//releaseinfo])[last()]/releaseinfo)[1]
22 </xsl:param>
23 </src:fragment>
24 </refsynopsisdiv>
25
26 <refsection><info><title>Description</title></info>
27
28 <para>The value of <parameter>refentry.version.profile</parameter> is
29 a string representing an XPath expression. It is evaluated at
30 run-time and used only if
31 <parameter>refentry.version.profile.enabled</parameter> is
32 non-zero. Otherwise, the <tag>refentry</tag> metadata-gathering logic
33 "hard coded" into the stylesheets is used.</para>
34
35 <para>A "source.name" is one part of a (potentially) two-part
36 <replaceable>Name</replaceable> <replaceable>Version</replaceable>
37 "source" field. For more details, see the documentation for the
38 <parameter>refentry.source.name.profile</parameter> parameter.</para>
39
40 </refsection>
41 </refentry>