Sophie

Sophie

distrib > Fedora > 17 > i386 > media > updates > by-pkgid > 9f452694b2d23dacae7f9cc757f9be50 > files > 973

docbook-style-xsl-1.78.1-1.fc17.noarch.rpm

<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>man.hyphenate</title><link rel="stylesheet" type="text/css" href="../reference.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="../index.html" title="DocBook XSL Stylesheets: Reference Documentation"><link rel="up" href="general.html" title="Hyphenation, justification, and breaking"><link rel="prev" href="general.html" title="Hyphenation, justification, and breaking"><link rel="next" href="man.hyphenate.urls.html" title="man.hyphenate.urls"><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.hyphenate</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="general.html">Prev</a> </td><th width="60%" align="center">Hyphenation, justification, and breaking</th><td width="20%" align="right"> <a accesskey="n" href="man.hyphenate.urls.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="man.hyphenate"></a><div class="titlepage"></div>

<div class="refnamediv"><h2><span class="refentrytitle">man.hyphenate</span></h2><p>
man.hyphenate
 &#8212; Enable hyphenation?
</p></div>

<div class="refsynopsisdiv"><h2>Synopsis</h2>
<a name="man.hyphenate.frag"></a><pre class="programlisting">
&lt;xsl:param name="man.hyphenate"&gt;0&lt;/xsl:param&gt;</pre>
</div>

<div class="refsection"><a name="idp7000016"></a><h2>Description</h2>

<p>If non-zero, hyphenation is enabled.</p>

<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3>
<p>The default value for this parameter is zero because groff is
not particularly smart about how it does hyphenation; it can end up
hyphenating a lot of things that you don't want hyphenated. To
mitigate that, the default behavior of the stylesheets is to suppress
hyphenation of computer inlines, filenames, and URLs. (You can
override the default behavior by setting non-zero values for the
<a href="../manpages/man.hyphenate.urls.html"><em class="parameter"><code>man.hyphenate.urls</code></em></a>,
<a href="../manpages/man.hyphenate.filenames.html"><em class="parameter"><code>man.hyphenate.filenames</code></em></a>, and
<a href="../manpages/man.hyphenate.computer.inlines.html"><em class="parameter"><code>man.hyphenate.computer.inlines</code></em></a> parameters.) But
the best way is still to just globally disable hyphenation, as the
stylesheets do by default.</p>

<p>The only good reason to enabled hyphenation is if you have also
enabled justification (which is disabled by default). The reason is
that justified text can look very bad unless you also hyphenate it; to
quote the <span class="quote">&#8220;<span class="quote">Hypenation</span>&#8221;</span> node from the groff info page:

</p><div class="blockquote"><blockquote class="blockquote">
  <p><span class="emphasis"><em>Since the odds are not great for finding a set of
  words, for every output line, which fit nicely on a line without
  inserting excessive amounts of space between words, 'gtroff'
  hyphenates words so that it can justify lines without inserting too
  much space between words.</em></span></p>
</blockquote></div><p>

So, if you set a non-zero value for the
<a href="../manpages/man.justify.html"><em class="parameter"><code>man.justify</code></em></a> parameter (to enable
justification), then you should probably also set a non-zero value for
<a href="../manpages/man.hyphenate.html"><em class="parameter"><code>man.hyphenate</code></em></a> (to enable hyphenation).</p>
</div>


</div>
</div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="general.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="general.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="man.hyphenate.urls.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Hyphenation, justification, and breaking </td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top"> man.hyphenate.urls</td></tr></table></div></body></html>