Difference between revisions of "Command old/setuptolerance"

From Wiki
Jump to navigation Jump to search
(Create reference page)
 
m (Taco moved page Command/setuptolerance to Command old/setuptolerance without leaving a redirect)
 
(14 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<!-- please remove this and the following line if you have checked this page -->
 
{{Reference_Cleanup}}
 
 
{{Reference
 
{{Reference
 
|name=setuptolerance
 
|name=setuptolerance
Line 7: Line 5:
  
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==
<table cellspacing="4" cellpadding="2" class="cmd">
 
  <tr>
 
    <td colspan="2" class="cmd">\setuptolerance<span class="first" >[...,...,...]</span></td>
 
  </tr>
 
  <tr valign="top" class="first">
 
    <td class="cmd">[...,...,...]</td>
 
    <td>horizontal vertical stretch space <strong>verystrict</strong> strict tolerant verytolerant </td>
 
  </tr>
 
</table>
 
  
 +
<syntax>setuptolerance</syntax>
  
 
== Description ==  
 
== Description ==  
<pre>
 
Use \setuptolerance[horizontal,...] for interword spacing and \setuptolerance[vertical,...] for column stretching. Don't try to combine these two.
 
  
horizontal is the default orientation, so the following two are equivalent:
+
Set up how tolerant TeX should be of ‘ugly’ stretching of spaces. The more stretching you allow, the easier it is for TeX to choose a stretched-out underfull line instead of a margin-invading overfull line.
  
\setuptolerance[horizontal,tolerant] and \setuptolerance[tolerant]
+
Use <code>\setuptolerance[horizontal,...]</code> for interword spacing and <code>\setuptolerance[vertical,...]</code> for column stretching. Don't try to combine these two.
 +
 
 +
The default orientation is ''horizontal'', so the following two are equivalent:
 +
 
 +
<texcode>
 +
\setuptolerance[horizontal,tolerant]
 +
% and
 +
\setuptolerance[tolerant]
 +
</texcode>
  
 
In horizontal orientation the keywords have the following effect:
 
In horizontal orientation the keywords have the following effect:
  
stretch:     \emergencystretch\bodyfontsize
+
{|
space:       \spaceskip .5em plus .25em minus .25em
+
|stretch:
verystrict:   \tolerance 200
+
|make <tt>\emergencystretch</tt> equal to <tt>\bodyfontsize</tt> (i.e. 11pt), default is 0pt
strict:       \tolerance 1500
+
|-
tolerant:     \tolerance 3000
+
|space:
verytolerant: \tolerance 4500
+
|<tt>\spaceskip .5em plus .25em minus .25em</tt>
 +
|-
 +
|verystrict:
 +
|<tt>\tolerance 200</tt>
 +
|-
 +
|strict:
 +
|<tt>\tolerance 1500</tt>
 +
|-
 +
|tolerant:
 +
|<tt>\tolerance 3000</tt>
 +
|-
 +
|verytolerant:
 +
|<tt>\tolerance 4500</tt>
 +
|}
 +
 
 +
In ''vertical'' orientation the keywords define a factor ''bottomtolerance''
 +
which is only used(?) in columns. The factors are:
 +
 
 +
{|
 +
|verystrict:
 +
|0
 +
|-
 +
|strict:
 +
|0.050
 +
|-
 +
|tolerant:
 +
|0.075
 +
|-
 +
|verytolerant:
 +
|0.100
 +
|}
 +
 
 +
== Tolerance of float captions ==
 +
 
 +
Float captions don't inherit the global tolerance setting, but instead use their own tolerance:
 +
 
 +
<texcode>
 +
%% global tolerance
 +
\setuptolerance
 +
  [tolerant]
  
in vertical orientation the keywords define a factor "bottomtolerance"
+
%% tolerance for captions
which is only used (?) in columns. The factors are:
+
\setupcaption
 +
  [align=tolerant]
 +
</texcode>
  
verystrict:  0
+
== Tolerance of framed texts ==
strict:      0.050
 
tolerant:    0.075
 
verytolerant: 0.100
 
</pre>
 
  
 +
Framed texts don't inherit the global tolerance setting, but instead use their own tolerance as well:
  
 +
<texcode>
 +
%% global tolerance
 +
\setuptolerance
 +
  [tolerant]
  
 +
%% tolerance for framed texts
 +
\setupframedtext
 +
  [align=verytolerant]
 +
</texcode>
 
== Example ==
 
== Example ==
 
<!-- Please fill in an example if you can -->
 
<!-- Please fill in an example if you can -->
  
 
== See also ==
 
== See also ==
<!-- something like [[cmd:goto|\goto]] -->
+
<!-- something like {{cmd|goto}} -->
 +
 
 +
== Help from ConTeXt-Mailinglist/Forum ==
 +
All issues with:
 +
{{Forum|{{SUBPAGENAME}}}}
  
[[Category:Reference/en|setuptolerance]]
+
[[Category:Command/Hyphenation|setuptolerance]]

Latest revision as of 14:38, 3 December 2021

\setuptolerance

Syntax

\setuptolerance[...,...]
[...,...]horizontal vertical verystrict strict tolerant verytolerant space stretch


Description

Set up how tolerant TeX should be of ‘ugly’ stretching of spaces. The more stretching you allow, the easier it is for TeX to choose a stretched-out underfull line instead of a margin-invading overfull line.

Use \setuptolerance[horizontal,...] for interword spacing and \setuptolerance[vertical,...] for column stretching. Don't try to combine these two.

The default orientation is horizontal, so the following two are equivalent:

\setuptolerance[horizontal,tolerant]
% and
\setuptolerance[tolerant]

In horizontal orientation the keywords have the following effect:

stretch: make \emergencystretch equal to \bodyfontsize (i.e. 11pt), default is 0pt
space: \spaceskip .5em plus .25em minus .25em
verystrict: \tolerance 200
strict: \tolerance 1500
tolerant: \tolerance 3000
verytolerant: \tolerance 4500

In vertical orientation the keywords define a factor bottomtolerance which is only used(?) in columns. The factors are:

verystrict: 0
strict: 0.050
tolerant: 0.075
verytolerant: 0.100

Tolerance of float captions

Float captions don't inherit the global tolerance setting, but instead use their own tolerance:

%% global tolerance
\setuptolerance
  [tolerant]

%% tolerance for captions
\setupcaption
  [align=tolerant]

Tolerance of framed texts

Framed texts don't inherit the global tolerance setting, but instead use their own tolerance as well:

%% global tolerance
\setuptolerance
  [tolerant]

%% tolerance for framed texts
\setupframedtext
  [align=verytolerant]

Example

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: