texinfo-doc-nonfree 6.5.0-1 / usr / share / doc / texinfo / html / Overfull-hboxes.html

This file is indexed.

/usr/share/doc/texinfo/html/Overfull-hboxes.html is in texinfo-doc-nonfree 6.5.0-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Texinfo (version 6.5, 25 August 2017),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.

Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011, 2012, 2013, 2014, 2015, 2016 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with the Front-Cover Texts being "A GNU Manual",
and with the Back-Cover Texts as in (a) below.  A copy of the license
is included in the section entitled "GNU Free Documentation
License".

(a) The FSF's Back-Cover Text is: "You have the freedom to copy and
modify this GNU manual.  Buying copies from the FSF supports it in
developing GNU and promoting software freedom." -->
<!-- Created by GNU Texinfo 6.4.90, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Overfull hboxes (GNU Texinfo 6.5)</title>

<meta name="description" content="Overfull hboxes (GNU Texinfo 6.5)">
<meta name="keywords" content="Overfull hboxes (GNU Texinfo 6.5)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Command-and-Variable-Index.html#Command-and-Variable-Index" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Hardcopy.html#Hardcopy" rel="up" title="Hardcopy">
<link href="_0040smallbook.html#g_t_0040smallbook" rel="next" title="@smallbook">
<link href="Preparing-for-TeX.html#Preparing-for-TeX" rel="prev" title="Preparing for TeX">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<a name="Overfull-hboxes"></a>
<div class="header">
<p>
Next: <a href="_0040smallbook.html#g_t_0040smallbook" accesskey="n" rel="next"><code>@smallbook</code></a>, Previous: <a href="Preparing-for-TeX.html#Preparing-for-TeX" accesskey="p" rel="prev">Preparing for TeX</a>, Up: <a href="Hardcopy.html#Hardcopy" accesskey="u" rel="up">Hardcopy</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html#Command-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Overfull-_0060_0060hboxes_0027_0027"></a>
<h3 class="section">19.10 Overfull &ldquo;hboxes&rdquo;</h3>
<a name="index-Overfull-hboxes"></a>
<a name="index-hbox_002c-overfull"></a>
<a name="index-Final-output"></a>

<p>TeX is sometimes unable to typeset a line within the normal
margins.  This most often occurs when TeX comes upon what it
interprets as a long word that it cannot hyphenate, such as an
electronic mail network address or a very long identifier.  When this
happens, TeX prints an error message like this:
</p>
<div class="example">
<pre class="example">Overfull @hbox (20.76302pt too wide)
</pre></div>

<a name="index-hbox"></a>
<p>(In TeX, lines are in &ldquo;horizontal boxes&rdquo;, hence the term, &ldquo;hbox&rdquo;.
&lsquo;<samp>@hbox</samp>&rsquo; is a TeX primitive not used in the Texinfo language.)
</p>
<p>TeX also provides the line number in the Texinfo source file and
the text of the offending line, which is marked at all the places that
TeX considered hyphenation.  See <a href="Debugging-with-TeX.html#Debugging-with-TeX">Debugging with TeX</a>, for more
information about typesetting errors.
</p>
<p>If the Texinfo file has an overfull hbox, you can rewrite the sentence
so the overfull hbox does not occur, or you can decide to leave it.  A
small excursion into the right margin often does not matter and may not
even be noticeable.
</p>
<p>If you have many overfull boxes and/or an antipathy to rewriting, you
can coerce TeX into greatly increasing the allowable interword
spacing, thus (if you&rsquo;re lucky) avoiding many of the bad line breaks,
like this:
</p>
<a name="index-_005cemergencystretch"></a>
<div class="example">
<pre class="example">@tex
\global\emergencystretch = .9\hsize
@end tex
</pre></div>

<p>(You should adjust the fraction as needed.)  This huge value for
<code>\emergencystretch</code> cannot be the default, since then the typeset
output would generally be of noticeably lower quality; its default
value is &lsquo;<samp>.15\hsize</samp>&rsquo;.  <code>\hsize</code> is the TeX dimension
containing the current line width.
</p>
<a name="index-Black-rectangle-in-hardcopy"></a>
<a name="index-Rectangle_002c-black-in-hardcopy"></a>
<a name="index-Box_002c-ugly-black-in-hardcopy"></a>
<a name="index-Ugly-black-rectangles-in-hardcopy"></a>
<p>For any overfull boxes you do have, TeX will print a large, ugly,
black rectangle beside the line that contains the overfull hbox unless
told otherwise.  This is so you will notice the location of the
problem if you are correcting a draft.
</p>
<a name="index-finalout"></a>
<p>To prevent such a monstrosity from marring your final printout, write
the following in the beginning of the Texinfo file on a line of its own,
before the <code>@titlepage</code> command:
</p>
<div class="example">
<pre class="example">@finalout
</pre></div>


<hr>
<div class="header">
<p>
Next: <a href="_0040smallbook.html#g_t_0040smallbook" accesskey="n" rel="next"><code>@smallbook</code></a>, Previous: <a href="Preparing-for-TeX.html#Preparing-for-TeX" accesskey="p" rel="prev">Preparing for TeX</a>, Up: <a href="Hardcopy.html#Hardcopy" accesskey="u" rel="up">Hardcopy</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html#Command-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>

APT Browse - Built by Thomas Orozco.