diff options
author | Remko Tronçon <git@el-tramo.be> | 2010-03-28 19:43:32 (GMT) |
---|---|---|
committer | Remko Tronçon <git@el-tramo.be> | 2010-03-28 19:44:49 (GMT) |
commit | 3afa4f741c26360245dc313bc368f508b26a6b96 (patch) | |
tree | 4fc9fedac990a099010fed8a4ee09ddc51c21cc5 /3rdParty/DocBook/XSL/params/man.th.extra3.max.length.xml | |
parent | 7548dabae7d10e48816142e508be651ada9f7bc3 (diff) | |
download | swift-contrib-3afa4f741c26360245dc313bc368f508b26a6b96.zip swift-contrib-3afa4f741c26360245dc313bc368f508b26a6b96.tar.bz2 |
Added DocBook infrastructure.
Imported most of "DocBook kit".
Added placeholder for Swiften developers guide.
Diffstat (limited to '3rdParty/DocBook/XSL/params/man.th.extra3.max.length.xml')
-rw-r--r-- | 3rdParty/DocBook/XSL/params/man.th.extra3.max.length.xml | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/3rdParty/DocBook/XSL/params/man.th.extra3.max.length.xml b/3rdParty/DocBook/XSL/params/man.th.extra3.max.length.xml new file mode 100644 index 0000000..77e55e4 --- /dev/null +++ b/3rdParty/DocBook/XSL/params/man.th.extra3.max.length.xml @@ -0,0 +1,42 @@ +<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="man.th.extra3.max.length"> +<refmeta> +<refentrytitle>man.th.extra3.max.length</refentrytitle> +<refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo> +</refmeta> +<refnamediv> +<refname>man.th.extra3.max.length</refname> +<refpurpose>Maximum length of extra3 in header/footer</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<src:fragment xml:id="man.th.extra3.max.length.frag"> +<xsl:param name="man.th.extra3.max.length">30</xsl:param> +</src:fragment> +</refsynopsisdiv> + +<refsection><info><title>Description</title></info> + +<para>Specifies the maximum permitted length of the +<literal>extra3</literal> part of the man-page <literal>.TH</literal> +title line header/footer. If the <literal>extra3</literal> content +exceeds the maxiumum specified, it is truncated down to the maximum +permitted length.</para> + +<para>The content of the <literal>extra3</literal> field is usually +displayed in the middle header of the page and is typically a "manual +name"; for example, "GTK+ User's Manual" (from the +<literal>gtk-options(7)</literal> man page).</para> + +<para>The default value for this parameter is reasonable but somewhat +arbitrary. If you are processing pages with long "manual names" -- or +especially if you are processing pages that have both long "title" +parts (command/function, etc. names) <emphasis>and</emphasis> long +manual names -- you may want to experiment with changing the value in +order to achieve the correct aesthetic results.</para> +</refsection> +</refentry> |