Sophie

Sophie

distrib > Mageia > 7 > i586 > media > core-release > by-pkgid > 6e019a662639ac6470f50dea3a4d8157 > files > 990

docbook-style-xsl-doc-1.79.2-4.mga7.noarch.rpm

<html><head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   <title>man.indent.refsect</title><link rel="stylesheet" type="text/css" href="../reference.css"><meta name="generator" content="DocBook XSL Stylesheets V1.79.2"><link rel="home" href="../index.html" title="DocBook XSL Stylesheets: Reference&nbsp;Documentation"><link rel="up" href="indent.html" title="Indentation"><link rel="prev" href="man.indent.width.html" title="man.indent.width"><link rel="next" href="man.indent.blurbs.html" title="man.indent.blurbs"><link rel="copyright" href="copyright.html" title="License"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">man.indent.refsect</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="man.indent.width.html">Prev</a>&nbsp;</td><th width="60%" align="center">Indentation</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="man.indent.blurbs.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="man.indent.refsect"></a><div class="titlepage"></div><div class="refnamediv"><h2><span class="refentrytitle">man.indent.refsect</span></h2><p>man.indent.refsect &#8212; Adjust indentation of refsect* and refsection?</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><a name="man.indent.refsect.frag"></a><pre class="programlisting">
&lt;xsl:param name="man.indent.refsect" select="0"&gt;&lt;/xsl:param&gt;</pre></div><div class="refsection"><a name="d0e24639"></a><h2>Description</h2><p>If the value of <em class="parameter"><code>man.indent.refsect</code></em> is
non-zero, the width of the left margin for
<code class="sgmltag-element">refsect1</code>, <code class="sgmltag-element">refsect2</code> and
<code class="sgmltag-element">refsect3</code> contents and titles (and first-level,
second-level, and third-level nested
<code class="sgmltag-element">refsection</code>instances) is adjusted by the value of
the <em class="parameter"><code>man.indent.width</code></em> parameter. With
<em class="parameter"><code>man.indent.width</code></em> set to its default value of
<code class="literal">3n</code>, the main results are that:

</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>contents of <code class="sgmltag-element">refsect1</code> are output with a
    left margin of three characters instead the roff default of seven
    or eight characters</p></li><li class="listitem"><p>contents of <code class="sgmltag-element">refsect2</code> are displayed in
    console output with a left margin of six characters instead the of
    the roff default of seven characters</p></li><li class="listitem"><p> the contents of <code class="sgmltag-element">refsect3</code> and nested
    <code class="sgmltag-element">refsection</code> instances are adjusted
    accordingly.</p></li></ul></div><p>

If instead the value of <em class="parameter"><code>man.indent.refsect</code></em> is
zero, no margin adjustment is done for <code class="literal">refsect*</code>
output.</p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>If your content is primarly comprised of
  <code class="sgmltag-element">refsect1</code> and <code class="sgmltag-element">refsect2</code> content
  (or the <code class="sgmltag-element">refsection</code> equivalent)&nbsp;&#8211; with few or
  no <code class="sgmltag-element">refsect3</code> or lower nested sections , you may be
  able to &#8220;conserve&#8221; space in your output by setting
  <em class="parameter"><code>man.indent.refsect</code></em> to a non-zero value. Doing
  so will &#8220;squeeze&#8221; the left margin in such as way as to provide an
  additional four characters of &#8220;room&#8221; per line in
  <code class="sgmltag-element">refsect1</code> output. That extra room may be useful
  if, for example, you have many verbatim sections with long lines in
  them.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="man.indent.width.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="indent.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="man.indent.blurbs.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">man.indent.width&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;man.indent.blurbs</td></tr></table></div></body></html>