+++ /dev/null
-<refentry xmlns="http://docbook.org/ns/docbook"\r
- xmlns:xlink="http://www.w3.org/1999/xlink"\r
- xmlns:xi="http://www.w3.org/2001/XInclude"\r
- xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"\r
- xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
- version="5.0" xml:id="man.indent.refsect">\r
-<refmeta>\r
-<refentrytitle>man.indent.refsect</refentrytitle>\r
-<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
-</refmeta>\r
-<refnamediv>\r
-<refname>man.indent.refsect</refname>\r
-<refpurpose>Adjust indentation of refsect* and refsection?</refpurpose>\r
-</refnamediv>\r
-\r
-<refsynopsisdiv>\r
-<src:fragment xml:id="man.indent.refsect.frag">\r
-<xsl:param name="man.indent.refsect" select="0"/></src:fragment>\r
-</refsynopsisdiv>\r
-\r
-<refsection><info><title>Description</title></info>\r
-\r
-<para>If the value of <parameter>man.indent.refsect</parameter> is\r
-non-zero, the width of the left margin for\r
-<tag>refsect1</tag>, <tag>refsect2</tag> and\r
-<tag>refsect3</tag> contents and titles (and first-level,\r
-second-level, and third-level nested\r
-<tag>refsection</tag>instances) is adjusted by the value of\r
-the <parameter>man.indent.width</parameter> parameter. With\r
-<parameter>man.indent.width</parameter> set to its default value of\r
-<literal>3n</literal>, the main results are that:\r
-\r
-<itemizedlist>\r
- <listitem>\r
- <para>contents of <tag>refsect1</tag> are output with a\r
- left margin of three characters instead the roff default of seven\r
- or eight characters</para>\r
- </listitem>\r
- <listitem>\r
- <para>contents of <tag>refsect2</tag> are displayed in\r
- console output with a left margin of six characters instead the of\r
- the roff default of seven characters</para>\r
- </listitem>\r
- <listitem>\r
- <para> the contents of <tag>refsect3</tag> and nested\r
- <tag>refsection</tag> instances are adjusted\r
- accordingly.</para>\r
- </listitem>\r
-</itemizedlist>\r
-\r
-If instead the value of <parameter>man.indent.refsect</parameter> is\r
-zero, no margin adjustment is done for <literal>refsect*</literal>\r
-output.</para>\r
-\r
-<tip>\r
- <para>If your content is primarly comprised of\r
- <tag>refsect1</tag> and <tag>refsect2</tag> content\r
- (or the <tag>refsection</tag> equivalent) – with few or\r
- no <tag>refsect3</tag> or lower nested sections , you may be\r
- able to “conserve” space in your output by setting\r
- <parameter>man.indent.refsect</parameter> to a non-zero value. Doing\r
- so will “squeeze” the left margin in such as way as to provide an\r
- additional four characters of “room” per line in\r
- <tag>refsect1</tag> output. That extra room may be useful\r
- if, for example, you have many verbatim sections with long lines in\r
- them.</para>\r
-</tip>\r
-\r
-</refsection>\r
-</refentry>\r