From ada368ebc5f83192b027eed64ba05ba661a1b14e Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 5 Feb 2015 22:40:18 +0000 Subject: eplain (5feb15) git-svn-id: svn://tug.org/texlive/trunk@36217 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/eplain/AUTHORS | 4 +- Master/texmf-dist/doc/eplain/ChangeLog | 16 ++++ Master/texmf-dist/doc/eplain/NEWS | 59 ++++++++------- Master/texmf-dist/doc/eplain/README | 6 +- Master/texmf-dist/doc/eplain/eplain.html | 122 ++++++++++++++++++++++++------- Master/texmf-dist/doc/eplain/eplain.pdf | Bin 745017 -> 747423 bytes 6 files changed, 148 insertions(+), 59 deletions(-) (limited to 'Master/texmf-dist/doc/eplain') diff --git a/Master/texmf-dist/doc/eplain/AUTHORS b/Master/texmf-dist/doc/eplain/AUTHORS index 391c66f94a3..ad73fefbe84 100644 --- a/Master/texmf-dist/doc/eplain/AUTHORS +++ b/Master/texmf-dist/doc/eplain/AUTHORS @@ -3,9 +3,9 @@ suggested by Paul Abrahams, who also wrote a few of the macros. Other macros are based on ones in The TeXbook. David Guichard and Adam Lewenberg improved the multicolumn macros. -Stepan Kasal has contributed several patches. +Stepan Kasal contributed several patches. Oleg Katsitadze added the hyperlink capabilities to Eplain. -Oren Patashnik has worked tirelessly on improving the BibTeX macros. +Oren Patashnik worked tirelessly on improving the BibTeX macros. Heiko Oberdiek wrote ifpdf.sty and pdfcrop.pl. Steven Smith wrote the commutative diagram macros. Philip Taylor wrote path.sty starting from an initial macro by Nelson Beebe. diff --git a/Master/texmf-dist/doc/eplain/ChangeLog b/Master/texmf-dist/doc/eplain/ChangeLog index 3221809d9bb..135c2841b75 100644 --- a/Master/texmf-dist/doc/eplain/ChangeLog +++ b/Master/texmf-dist/doc/eplain/ChangeLog @@ -1,3 +1,19 @@ +2015-02-04 Karl Berry + + * Version 3.7. + +2014-12-11 Karl Berry + + * xeplain.tex: new macro \raggedleft a la plain's raggedright. + Suggested by Dorai Sitaram, 8 Dec 2014 18:22:35. + * doc/userdef.texi (Justification): document it. + * test/raggedleft.tex: test it. + +2014-12-09 Karl Berry + + * doc/userdef.texi (Packages known to work): show \fbox + contributed by Dan and Helmut. + 2013-09-30 Karl Berry * Version 3.6. diff --git a/Master/texmf-dist/doc/eplain/NEWS b/Master/texmf-dist/doc/eplain/NEWS index b4f575fa9d5..b4842b799da 100644 --- a/Master/texmf-dist/doc/eplain/NEWS +++ b/Master/texmf-dist/doc/eplain/NEWS @@ -1,21 +1,26 @@ -$Id: NEWS 24 2013-09-30 18:42:10Z karl $ +$Id: NEWS 29 2015-02-05 18:41:49Z karl $ This file records noteworthy changes. This file is public domain. -3.6 (30 September 2013) + 3.7 (5 February 2015) +* Add \raggedleft, analogous to plain's \raggedright. +* Show a possible definition of \fbox in the manual, + as it is not defined by miniltx. + + 3.6 (30 September 2013) * ignore spaces after optional arguments. - -3.5 (13 February 2013) + + 3.5 (13 February 2013) * make \providecommand and \newcommand \long, like LaTeX. * restored the catcode of @ at \endpackages. * ifpdf.sty: update to latest version. - -3.4 (21 February 2010) + + 3.4 (21 February 2010) * Eplain repository moved from cvs.sarovar.org:/cvsroot/eplain to svn://tug.org/eplain/trunk. * Changed \ProcessOptions from miniltx.tex to gobble the optional star argument, to accommodate the new version of epstopdf.sty. - -3.3 (21 July 2009) + + 3.3 (21 July 2009) * New commands \eqnum and \eqalignnum, counterparts of \(l)eqno and \(l)eqalignno, producing equation numbers which can be uniformly transformed to right-aligned (\righteqnumbers) or left-aligned @@ -31,8 +36,8 @@ This file records noteworthy changes. This file is public domain. * Updated ifpdf.sty. * LaTeX package reloading warnings are now not shown on the terminal. * Documentation improvements. - -3.2 (26 November 2007) + + 3.2 (26 November 2007) * Fixed a bug which caused silent indexing macros to output spurious space in vertical mode. * Added a switch to disable index file input/output. @@ -43,8 +48,7 @@ This file records noteworthy changes. This file is public domain. and producing columns too high to fit on a page. Also improved appearance of the last column, which often came out spaced out. - -3.1 (3 December 2006) + 3.1 (3 December 2006) General: * Rearranged the distro to comply with TDS. @@ -97,8 +101,7 @@ Other: * Added new \nolastlinelisting listing hook which omits the last (empty) line of the file. - -3.0 (20 September 2005) + 3.0 (20 September 2005) * Eplain now hosted at Sarovar: http://sarovar.org/projects/eplain/ * Support for hyperlinks! * Support for (a few) LaTeX packages, notably graphicx and color. @@ -111,16 +114,16 @@ Other: avoid shift of page body. [2004-08-31] * New documentation for the hyperlinks and the LaTeX package support, many improvements of the old docs. - -2.8 (2 September 2000) + + 2.8 (2 September 2000) * Added a section on user-defined environments to progdef.texi and fixed a few typos in documentation. Suggested by Paul Abrahams [25 April 1999] * Added a fix to a buggy double-column macro that Adam Lewenberg introduced when attempting to fix the balancing macros. [9 April 2000] - -2.7 (14 January 1998) + + 2.7 (14 January 1998) * Added the control sequence \gutterbox as a hook to add arbitrary vertical material between columns in multi-column mode. [5 December 1997] * Removed spurious space in \verbatim macro. [26 March 1997] @@ -131,19 +134,19 @@ Other: amstex. [2 March 1996]. * Changed all dimension values in margin setting macros to 'true'; redefined \magnification so that this works. - -2.6 (2 May 1994) + + 2.6 (2 May 1994) * Indexing support (in conjunction with MakeIndex). * Generalization of .toc files for lists of figures/tables, etc. * \commdiag and other arrow macros work again. * \eqalignno right-justifies the first column in \leftdisplays, as in non-leftdisplays. - -2.5 (31 March 1994) + + 2.5 (31 March 1994) * Do not ignore first \ref command. * Make \verbatim (and the || feature) work again (thanks to Dorai Sitaram). - -2.4 (16 March 1994) + + 2.4 (16 March 1994) * \catcode of @ properly restored (reported by adam@symcom.math.uiuc.edu). * `| ' in \verbatim argument documented (also reported by adam). * | not hardwired as the \verbatim escape character (thanks to @@ -157,8 +160,8 @@ Other: Column ejects also supported (sort of). * \parskip set to zero before each footnote (but not for the footnote text). * \ref and \cite conflicts with amstex described in manual. - -2.3 (1 March 1993) + + 2.3 (1 March 1993) * New macros for arbitrary cross-references. * \iterate is redefined to allow \else in loops. * texnames.sty uses \spacefactor1000 instead of an empty hbox to handle @@ -167,8 +170,8 @@ Other: * \centereddisplays and \leftdisplays can be repeated, and called in any order. * New macros \csn and \ece to do common expansion things. - -2.2 (11 November 1992) + + 2.2 (11 November 1992) * New \toks register \everylist, expanded at the start of every list. * \footnoterulewidth defined as 2in, not 2true in, thus allowing the use of \mag after reading eplain.tex. The `2true in' was Knuth's, but I diff --git a/Master/texmf-dist/doc/eplain/README b/Master/texmf-dist/doc/eplain/README index cbaa0914840..3059f18cf67 100644 --- a/Master/texmf-dist/doc/eplain/README +++ b/Master/texmf-dist/doc/eplain/README @@ -23,13 +23,13 @@ and "see also" index entries, and making index entries with hyperlinks. The original Eplain macros and most of the manual are in the public -domain. Other pieces are covered by other licenses); +domain. Other pieces are covered by other licenses; see the file headers for specifics. It is entirely free software. Eplain was originally developed for the book TeX for the Impatient, published by Addison-Wesley in 1990. That book is now freely available, -from http://www.gnu.org/software/teximpatient, along with a French -translation. +from http://www.gnu.org/software/teximpatient, along with several +translations. email: bug-eplain@tug.org www: http://tug.org/eplain 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 @@ - - + Eplain: Expanded Plain TeX @@ -25,20 +25,20 @@ updates throughout. --> - + @@ -58,7 +58,7 @@ ul.no-bullet {list-style: none} - +

Eplain: Expanded Plain TeX

@@ -268,13 +268,13 @@ ul.no-bullet {list-style: none}

-Next: , Up: (dir)   [Contents][Index]

+Next: , Up: (dir)   [Contents][Index]

Eplain

-

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.

@@ -3487,6 +3487,45 @@ a title macro might be defined: \def\endtitle{\endgroup} + + + + + + +

In addition, Eplain defines \raggedleft, analogous to plain +TeX’s \raggedright. 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’t treated +specially. Just like plain’s \raggedright, it also resets +\spaceskip and \xspaceskip so that interword spacing is +uniform. It also sets \parfillskip to zero so that last lines +of paragraphs are also “ragged left”. Finally, \leftskip’s +new value is taken from a new glue register, \raggedleft; its +default value is 0pt plus 2em, the same as +\raggedright’s \rightskip. +

+

Here’s an 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}
+}
+
+ +

Despite \raggedleft resetting \parfillskip to zero, +TeX’s line breaking may still prefer to make the last line of a +paragraph considerably shorter than the rest, to minimize overall +badness. Increasing \raggedleftskip may help somewhat, but +using \emergencystretch, retaining interword stretchability by +assigning \leftskip directly, or even forcing line breaks may +be necessary. +

+
@@ -4249,14 +4288,15 @@ inside your document without resorting to any external tools.
graphicx (‘1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)’)
-

http://www.ctan.org/tex-archive/macros/latex/required/graphics/grfguide.pdf +

http://www.ctan.org/pkg/graphics

-

These packages are from the LaTeX graphics collection. They +

These packages are from the LaTeX graphics collection. (The +independent xcolor package does not work with Eplain.) They provide commands for changing text/page colors, text rotation and scaling, and much more.

@@ -4268,7 +4308,7 @@ scaling, and much more.

Warning 1: If you encounter problems loading one of -these packages under pdfTeX (more specifically, when pdfTeX +these packages under pdfTeX (when pdfTeX reads supp-mis.tex), the cause may be an outdated supp-mis.tex (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 supp-mis.tex and the accompanying supp-pdf.tex from http://www.ctan.org/tex-archive/macros/pdftex/graphics. To convince TeX to use the new files, you have the following -options in the decreasing order of preference: +options:

  1. put the new files in the same directory with your document; @@ -4305,9 +4345,27 @@ the system texmf tree.
    End of warning 1. pdfTeX, the cause may be an outdated pdfTeX color and graphics driver pdftex.def. The problem was fixed in pdftex.def version 0.03p. You can obtain an up-to-date version from -http://www.ctan.org/tex-archive/graphics/pdftex/pdftex.def.
    +http://www.ctan.org/pkg/pdftex-def.
    End of warning 2.

    +

    The \fcolorbox macro provided by the color package +requires the macro \fbox to work, but miniltx does not +provide that. Here is a definition for it that uses Eplain’s +\boxit (see Boxes), thanks to Dan Luecking and Helmut +Jarausch: +

    +
    +
    \makeatletter
    +\def\fbox#1{{%
    +  \hruledefaultheight=\fboxrule
    +  \hruledefaultdepth=0pt
    +  \vruledefaultwidth=\fboxrule
    +  \let\boxitspace\fboxsep % use miniltx register
    +  \boxit{\color@begingroup\hbox{#1}\color@endgroup}%
    +}}
    +\makeatother
    +
    +

    The graphics/graphicx 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 -\ttfamily to switch to the typewrite type. This command is not +\ttfamily to switch to typewriter type. This command is not defined by miniltx.tex, therefore Eplain defines it and makes it equivalent to plain TeX’s @@ -4425,21 +4483,21 @@ Previous:

    -

    http://www.ctan.org/tex-archive/macros/latex/contrib/hyperref +

    http://www.ctan.org/pkg/hyperref

    -

    This package depends heavily on LaTeX, so that it is mostly +

    This package depends heavily on LaTeX, so that it is essentially unusable outside of LaTeX. Eplain provides its own macros for -creating hyperlinks, see Hyperlinks. +creating hyperlinks; see Hyperlinks.

    pict2e (‘2005/07/15 v0.2r Improved picture commands (HjG,RN)’)
    -

    http://www.ctan.org/tex-archive/macros/latex/contrib/pict2e +

    http://www.ctan.org/pkg/pict2e

    xcolor (‘2005/06/06 v2.03 LaTeX color extensions (UK)’)
    -

    http://www.ctan.org/tex-archive/macros/latex/contrib/xcolor +

    http://www.ctan.org/pkg/xcolor

    @@ -9154,6 +9212,8 @@ Next: , Previ + + + + + + + + @@ -9852,6 +9920,8 @@ Next: , Previ
    Jump to:   @   +\ +  
    A   @@ -9215,6 +9275,14 @@ Next: , Previ
    @hllabel: Link types for pdftex and dvipdfm
    @indexproof insertion class: Proofing index terms

    \
    \leftskip: Justification
    \raggedleft: Justification
    \raggedleftskip: Justification
    \raggedright: Justification
    \spaceskip, reset by \ragged...: Justification
    \xspaceskip, reset by \ragged...: Justification

    A
    abovecolumnskip: Multiple columns
    abovecolumnspenalty: Tables
    Jump to:   @   +\ +  
    A   diff --git a/Master/texmf-dist/doc/eplain/eplain.pdf b/Master/texmf-dist/doc/eplain/eplain.pdf index ee9737e3fed..032ed02dbc9 100644 Binary files a/Master/texmf-dist/doc/eplain/eplain.pdf and b/Master/texmf-dist/doc/eplain/eplain.pdf differ -- cgit v1.2.3