summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/eplain/eplain.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/eplain/eplain.html')
-rw-r--r--Master/texmf-dist/doc/eplain/eplain.html122
1 files changed, 96 insertions, 26 deletions
diff --git a/Master/texmf-dist/doc/eplain/eplain.html b/Master/texmf-dist/doc/eplain/eplain.html
index ec3000f8cc1..992e29bb99c 100644
--- a/Master/texmf-dist/doc/eplain/eplain.html
+++ b/Master/texmf-dist/doc/eplain/eplain.html
@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
-<!-- This manual documents the Eplain macros, version 3.6,
-September 2013. Eplain provides functionality for plain TeX that
+<!-- This manual documents the Eplain macros, version 3.7,
+February 2015. Eplain provides functionality for plain TeX that
is intended to be useful regardless of how your document is actually
formatted.
@@ -12,7 +12,7 @@ macros; this chapter is under the GNU General Public License. Adam
Lewenberg has made additions and corrections. Oleg Katsitadze wrote
the section on LaTeX packages and the chapter on hyperlinks, and
updates throughout. -->
-<!-- Created by Texinfo 5.2+dev, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by Texinfo 5.2dev+dev, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Eplain: Expanded Plain TeX</title>
@@ -25,20 +25,20 @@ updates throughout. -->
<link href="#Top" rel="start" title="Top">
<link href="#Macro-index" rel="index" title="Macro index">
<link href="#SEC_Contents" rel="contents" title="Table of Contents">
-<link href="dir.html#Top" rel="up" title="(dir)">
+<link href="http://tug.org/texinfohtml/" rel="up" title="(dir)">
<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.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
-div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
-kbd {font-style:oblique}
+kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
@@ -47,10 +47,10 @@ 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.nocodebreak {white-space:nowrap}
-span.nolinebreak {white-space:nowrap}
-span.roman {font-family:serif; font-weight:normal}
-span.sansserif {font-family:sans-serif; font-weight:normal}
+span.nocodebreak {white-space: nowrap}
+span.nolinebreak {white-space: nowrap}
+span.roman {font-family: serif; font-weight: normal}
+span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
@@ -58,7 +58,7 @@ ul.no-bullet {list-style: none}
</head>
-<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
+<body lang="en">
<h1 class="settitle" align="center">Eplain: Expanded Plain TeX</h1>
@@ -268,13 +268,13 @@ ul.no-bullet {list-style: none}
<a name="Top"></a>
<div class="header">
<p>
-Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml/" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Eplain"></a>
<h1 class="top">Eplain</h1>
-<p>This manual documents the Eplain macros, version 3.6,
-September 2013. Eplain provides functionality for plain TeX that
+<p>This manual documents the Eplain macros, version 3.7,
+February 2015. Eplain provides functionality for plain TeX that
is intended to be useful regardless of how your document is actually
formatted.
</p>
@@ -3487,6 +3487,45 @@ a title macro might be defined:
\def\endtitle{\endgroup}
</pre></div>
+<a name="index-_005craggedleft"></a>
+<a name="index-_005craggedright"></a>
+<a name="index-_005cleftskip"></a>
+<a name="index-_005craggedleftskip"></a>
+<a name="index-_005cspaceskip_002c-reset-by-_005cragged_002e_002e_002e"></a>
+<a name="index-_005cxspaceskip_002c-reset-by-_005cragged_002e_002e_002e"></a>
+<p>In addition, Eplain defines <code>\raggedleft</code>, analogous to plain
+TeX&rsquo;s <code>\raggedright</code>. This macro is also typically used
+inside a group, but unlike the environments above, TeX does normal
+line breaking; that is, ends-of-lines in the input file aren&rsquo;t treated
+specially. Just like plain&rsquo;s <code>\raggedright</code>, it also resets
+<code>\spaceskip</code> and <code>\xspaceskip</code> so that interword spacing is
+uniform. It also sets <code>\parfillskip</code> to zero so that last lines
+of paragraphs are also &ldquo;ragged left&rdquo;. Finally, <code>\leftskip</code>&rsquo;s
+new value is taken from a new glue register, <code>\raggedleft</code>; its
+default value is <code>0pt plus 2em</code>, the same as
+<code>\raggedright</code>&rsquo;s <code>\rightskip</code>.
+</p>
+<p>Here&rsquo;s an example:
+</p>
+<div class="example">
+<pre class="example">{\raggedleft This text will be set ragged left,
+although the left margin won't be too ragged by default.
+You may well want to increase the value of
+{\tt \char`\\raggedleftskip} before calling the macro.
+It's necessary to end the paragraph before ending the group
+or the setting won't have any effect, so: {\tt \char`\\par}
+}
+</pre></div>
+
+<p>Despite <code>\raggedleft</code> resetting <code>\parfillskip</code> to zero,
+TeX&rsquo;s line breaking may still prefer to make the last line of a
+paragraph considerably shorter than the rest, to minimize overall
+badness. Increasing <code>\raggedleftskip</code> may help somewhat, but
+using <code>\emergencystretch</code>, retaining interword stretchability by
+assigning <code>\leftskip</code> directly, or even forcing line breaks may
+be necessary.
+</p>
+
<hr>
<a name="Tables"></a>
@@ -4249,14 +4288,15 @@ inside your document without resorting to any external tools.
</dd>
<dt>graphicx (&lsquo;<samp>1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)</samp>&rsquo;)</dt>
<dd><a name="index-graphicx_002esty"></a>
-<p><a href="http://www.ctan.org/tex-archive/macros/latex/required/graphics/grfguide.pdf">http://www.ctan.org/tex-archive/macros/latex/required/graphics/grfguide.pdf</a>
+<p><a href="http://www.ctan.org/pkg/graphics">http://www.ctan.org/pkg/graphics</a>
</p>
<a name="index-graphics-collection_002c-LaTeX-1"></a>
<a name="index-LaTeX-graphics-collection-1"></a>
<a name="index-color"></a>
<a name="index-rotation"></a>
<a name="index-scaling"></a>
-<p>These packages are from the LaTeX graphics collection. They
+<p>These packages are from the LaTeX graphics collection. (The
+independent <samp>xcolor</samp> package does not work with Eplain.) They
provide commands for changing text/page colors, text rotation and
scaling, and much more.
</p>
@@ -4268,7 +4308,7 @@ scaling, and much more.
<a name="index-supp_002dmis_002etex_002c-problems-with-pdfTeX"></a>
<a name="index-supp_002dpdf_002etex"></a>
<p><strong>Warning&nbsp;1:</strong> If you encounter problems loading one of
-these packages under pdfTeX (more specifically, when pdfTeX
+these packages under pdfTeX (when pdfTeX
reads <samp>supp-mis.tex</samp>), the cause may be an outdated
<samp>supp-mis.tex</samp> (part of ConTeXt, a typesetting system for
TeX) installed on your system. The problem was fixed in
@@ -4277,7 +4317,7 @@ up-to-date versions of <samp>supp-mis.tex</samp> and the accompanying
<samp>supp-pdf.tex</samp> from
<a href="http://www.ctan.org/tex-archive/macros/pdftex/graphics">http://www.ctan.org/tex-archive/macros/pdftex/graphics</a>.
To convince TeX to use the new files, you have the following
-options in the decreasing order of preference:
+options:
</p>
<ol>
<li> put the new files in the same directory with your document;
@@ -4305,9 +4345,27 @@ the system <samp>texmf</samp> tree.<br> <strong>End of warning&nbsp;1.</strong>
pdfTeX, the cause may be an outdated pdfTeX color and graphics
driver <samp>pdftex.def</samp>. The problem was fixed in <samp>pdftex.def</samp>
version&nbsp;0.03p. You can obtain an up-to-date version from
-<a href="http://www.ctan.org/tex-archive/graphics/pdftex/pdftex.def">http://www.ctan.org/tex-archive/graphics/pdftex/pdftex.def</a>.<br>
+<a href="http://www.ctan.org/pkg/pdftex-def">http://www.ctan.org/pkg/pdftex-def</a>.<br>
<strong>End of warning&nbsp;2.</strong>
</p>
+<p>The <code>\fcolorbox</code> macro provided by the <code>color</code> package
+requires the macro <code>\fbox</code> to work, but <code>miniltx</code> does not
+provide that. Here is a definition for it that uses Eplain&rsquo;s
+<code>\boxit</code> (see <a href="#Boxes">Boxes</a>), thanks to Dan Luecking and Helmut
+Jarausch:
+</p>
+<div class="example">
+<pre class="example">\makeatletter
+\def\fbox#1{{%
+ \hruledefaultheight=\fboxrule
+ \hruledefaultdepth=0pt
+ \vruledefaultwidth=\fboxrule
+ \let\boxitspace\fboxsep % use miniltx register
+ \boxit{\color@begingroup\hbox{#1}\color@endgroup}%
+}}
+\makeatother
+</pre></div>
+
<a name="index-omitting-typesetting-of-graphics"></a>
<a name="index-graphics_002c-omitting-typesetting-of"></a>
<p>The <samp>graphics</samp>/<samp>graphicx</samp> packages have the option
@@ -4317,7 +4375,7 @@ graphics but instead typeset a box with the dimensions of the graphics
and the name of the graphics file in typewriter type at the center of
the box. These packages expect the LaTeX-provided command
<a name="index-ttfamily"></a>
-<code>\ttfamily</code> to switch to the typewrite type. This command is not
+<code>\ttfamily</code> to switch to typewriter type. This command is not
defined by <samp>miniltx.tex</samp>, therefore Eplain defines it and makes it
equivalent to plain&nbsp;TeX&rsquo;s
<a name="index-tt"></a>
@@ -4425,21 +4483,21 @@ Previous: <a href="#Packages-known-to-work" accesskey="p" rel="prev">Packages kn
<dl compact="compact">
<dt>hyperref</dt>
<dd><a name="index-hyperref_002esty"></a>
-<p><a href="http://www.ctan.org/tex-archive/macros/latex/contrib/hyperref">http://www.ctan.org/tex-archive/macros/latex/contrib/hyperref</a>
+<p><a href="http://www.ctan.org/pkg/hyperref">http://www.ctan.org/pkg/hyperref</a>
</p>
-<p>This package depends heavily on LaTeX, so that it is mostly
+<p>This package depends heavily on LaTeX, so that it is essentially
unusable outside of LaTeX. Eplain provides its own macros for
-creating hyperlinks, see <a href="#Hyperlinks">Hyperlinks</a>.
+creating hyperlinks; see <a href="#Hyperlinks">Hyperlinks</a>.
</p>
</dd>
<dt>pict2e (&lsquo;<samp>2005/07/15 v0.2r Improved picture commands (HjG,RN)</samp>&rsquo;)</dt>
<dd><a name="index-pict2e_002esty"></a>
-<p><a href="http://www.ctan.org/tex-archive/macros/latex/contrib/pict2e">http://www.ctan.org/tex-archive/macros/latex/contrib/pict2e</a>
+<p><a href="http://www.ctan.org/pkg/pict2e">http://www.ctan.org/pkg/pict2e</a>
</p>
</dd>
<dt>xcolor (&lsquo;<samp>2005/06/06 v2.03 LaTeX color extensions (UK)</samp>&rsquo;)</dt>
<dd><a name="index-xcolor_002esty"></a>
-<p><a href="http://www.ctan.org/tex-archive/macros/latex/contrib/xcolor">http://www.ctan.org/tex-archive/macros/latex/contrib/xcolor</a>
+<p><a href="http://www.ctan.org/pkg/xcolor">http://www.ctan.org/pkg/xcolor</a>
</p></dd>
</dl>
@@ -9154,6 +9212,8 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ
<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Macro-index_fn_symbol-1"><b>@</b></a>
&nbsp;
+<a class="summary-letter" href="#Macro-index_fn_symbol-2"><b>\</b></a>
+ &nbsp;
<br>
<a class="summary-letter" href="#Macro-index_fn_letter-A"><b>A</b></a>
&nbsp;
@@ -9215,6 +9275,14 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ
<tr><td></td><td valign="top"><a href="#index-_0040hllabel-3"><code>@hllabel</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0040indexproof-insertion-class"><code>@indexproof <span class="roman">insertion class</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Proofing-index-terms">Proofing index terms</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
+<tr><th><a name="Macro-index_fn_symbol-2">\</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cleftskip"><code>\leftskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Justification">Justification</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005craggedleft"><code>\raggedleft</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Justification">Justification</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005craggedleftskip"><code>\raggedleftskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Justification">Justification</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005craggedright"><code>\raggedright</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Justification">Justification</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cspaceskip_002c-reset-by-_005cragged_002e_002e_002e"><code>\spaceskip<span class="roman">, reset by <code>\ragged...</code></span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Justification">Justification</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cxspaceskip_002c-reset-by-_005cragged_002e_002e_002e"><code>\xspaceskip<span class="roman">, reset by <code>\ragged...</code></span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Justification">Justification</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Macro-index_fn_letter-A">A</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-abovecolumnskip"><code>abovecolumnskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Multiple-columns">Multiple columns</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-abovecolumnspenalty"><code>abovecolumnspenalty</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Tables">Tables</a></td></tr>
@@ -9852,6 +9920,8 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ
</table>
<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Macro-index_fn_symbol-1"><b>@</b></a>
&nbsp;
+<a class="summary-letter" href="#Macro-index_fn_symbol-2"><b>\</b></a>
+ &nbsp;
<br>
<a class="summary-letter" href="#Macro-index_fn_letter-A"><b>A</b></a>
&nbsp;