summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
Diffstat (limited to '3rdParty/DocBook/XSL/params/man.indent.refsect.xml')
-rw-r--r--3rdParty/DocBook/XSL/params/man.indent.refsect.xml70
1 files changed, 70 insertions, 0 deletions
diff --git a/3rdParty/DocBook/XSL/params/man.indent.refsect.xml b/3rdParty/DocBook/XSL/params/man.indent.refsect.xml
new file mode 100644
index 0000000..2865f8c
--- /dev/null
+++ b/3rdParty/DocBook/XSL/params/man.indent.refsect.xml
@@ -0,0 +1,70 @@
+<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.indent.refsect">
+<refmeta>
+<refentrytitle>man.indent.refsect</refentrytitle>
+<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>man.indent.refsect</refname>
+<refpurpose>Adjust indentation of refsect* and refsection?</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<src:fragment xml:id="man.indent.refsect.frag">
+<xsl:param name="man.indent.refsect" select="0"/></src:fragment>
+</refsynopsisdiv>
+
+<refsection><info><title>Description</title></info>
+
+<para>If the value of <parameter>man.indent.refsect</parameter> is
+non-zero, the width of the left margin for
+<tag>refsect1</tag>, <tag>refsect2</tag> and
+<tag>refsect3</tag> contents and titles (and first-level,
+second-level, and third-level nested
+<tag>refsection</tag>instances) is adjusted by the value of
+the <parameter>man.indent.width</parameter> parameter. With
+<parameter>man.indent.width</parameter> set to its default value of
+<literal>3n</literal>, the main results are that:
+
+<itemizedlist>
+ <listitem>
+ <para>contents of <tag>refsect1</tag> are output with a
+ left margin of three characters instead the roff default of seven
+ or eight characters</para>
+ </listitem>
+ <listitem>
+ <para>contents of <tag>refsect2</tag> are displayed in
+ console output with a left margin of six characters instead the of
+ the roff default of seven characters</para>
+ </listitem>
+ <listitem>
+ <para> the contents of <tag>refsect3</tag> and nested
+ <tag>refsection</tag> instances are adjusted
+ accordingly.</para>
+ </listitem>
+</itemizedlist>
+
+If instead the value of <parameter>man.indent.refsect</parameter> is
+zero, no margin adjustment is done for <literal>refsect*</literal>
+output.</para>
+
+<tip>
+ <para>If your content is primarly comprised of
+ <tag>refsect1</tag> and <tag>refsect2</tag> content
+ (or the <tag>refsection</tag> equivalent) – with few or
+ no <tag>refsect3</tag> or lower nested sections , you may be
+ able to “conserve” space in your output by setting
+ <parameter>man.indent.refsect</parameter> to a non-zero value. Doing
+ so will “squeeze” the left margin in such as way as to provide an
+ additional four characters of “room” per line in
+ <tag>refsect1</tag> output. That extra room may be useful
+ if, for example, you have many verbatim sections with long lines in
+ them.</para>
+</tip>
+
+</refsection>
+</refentry>