<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>man.th.title.max.length</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 Documentation"><link rel="up" href="th.html" title="Page header/footer"><link rel="prev" href="man.th.extra3.suppress.html" title="man.th.extra3.suppress"><link rel="next" href="man.th.extra2.max.length.html" title="man.th.extra2.max.length"><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.th.title.max.length</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="man.th.extra3.suppress.html">Prev</a> </td><th width="60%" align="center">Page header/footer</th><td width="20%" align="right"> <a accesskey="n" href="man.th.extra2.max.length.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="man.th.title.max.length"></a><div class="titlepage"></div><div class="refnamediv"><h2><span class="refentrytitle">man.th.title.max.length</span></h2><p>man.th.title.max.length — Maximum length of title in header/footer</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><a name="man.th.title.max.length.frag"></a><pre class="programlisting">
<xsl:param name="man.th.title.max.length">20</xsl:param>
</pre></div><div class="refsection"><a name="d0e27184"></a><h2>Description</h2><p>Specifies the maximum permitted length of the title part of the
man-page <code class="literal">.TH</code> title line header/footer. If the title
exceeds the maxiumum specified, it is truncated down to the maximum
permitted length.</p><div class="refsection"><a name="d0e27193"></a><h3>Details</h3><p>Every man page generated using the DocBook stylesheets has a
title line, specified using the <code class="literal">TH</code> roff
macro. Within that title line, there is always, at a minimum, a title,
followed by a section value (representing a man "section" -- usually
just a number).</p><p>The title and section are displayed, together, in the visible
header of each page. Where in the header they are displayed depends on
OS the man page is viewed on, and on what version of nroff/groff/man
is used for viewing the page. But, at a minimum and across all
systems, the title and section are displayed on the right-hand column
of the header. On many systems -- those with a modern groff, including
Linux systems -- they are displayed twice: both in the left and right
columns of the header.</p><p>So if the length of the title exceeds a certain percentage of
the column width in which the page is viewed, the left and right
titles can end up overlapping, making them unreadable, or breaking to
another line, which doesn't look particularly good.</p><p>So the stylesheets provide the
<em class="parameter"><code>man.th.title.max.length</code></em> parameter as a means
for truncating titles that exceed the maximum length that can be
viewing properly in a page header.</p><p>The default value is reasonable but somewhat arbitrary. If you
have pages with long titles, you may want to experiment with changing
the value in order to achieve the correct aesthetic results.</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.th.extra3.suppress.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="th.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="man.th.extra2.max.length.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">man.th.extra3.suppress </td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top"> man.th.extra2.max.length</td></tr></table></div></body></html>
distrib
>
Mageia
>
7
>
i586
>
media
>
core-release
>
by-pkgid
>
6e019a662639ac6470f50dea3a4d8157
>
files
>
1015
