]> git.stg.codes - stg.git/blobdiff - doc/help/xslt/params/man.indent.refsect.xml
xslt filters moved upper, Makefiles fixed to use bundled xslt filters
[stg.git] / doc / help / xslt / params / man.indent.refsect.xml
diff --git a/doc/help/xslt/params/man.indent.refsect.xml b/doc/help/xslt/params/man.indent.refsect.xml
deleted file mode 100644 (file)
index 2865f8c..0000000
+++ /dev/null
@@ -1,70 +0,0 @@
-<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>