texlive[42461] Build/source/texk/dvipsk: document new papersize

commits+karl at tug.org commits+karl at tug.org
Tue Nov 8 19:41:55 CET 2016


Revision: 42461
          http://tug.org/svn/texlive?view=revision&revision=42461
Author:   karl
Date:     2016-11-08 19:41:55 +0100 (Tue, 08 Nov 2016)
Log Message:
-----------
document new papersize special behavior and options

Modified Paths:
--------------
    trunk/Build/source/texk/dvipsk/ChangeLog
    trunk/Build/source/texk/dvipsk/NEWS
    trunk/Build/source/texk/dvipsk/dvips.info
    trunk/Build/source/texk/dvipsk/dvips.texi

Modified: trunk/Build/source/texk/dvipsk/ChangeLog
===================================================================
--- trunk/Build/source/texk/dvipsk/ChangeLog	2016-11-08 05:09:00 UTC (rev 42460)
+++ trunk/Build/source/texk/dvipsk/ChangeLog	2016-11-08 18:41:55 UTC (rev 42461)
@@ -1,3 +1,9 @@
+2016-11-08  Karl Berry  <karl at freefriends.org>
+
+	* dvips.texi,
+	* NEWS: document new papersize special behavior and options.
+	Original report at http://tex.stackexchange.com/questions/336545.
+
 2016-11-01  Akira Kakuto  <kakuto at fuk.kindai.ac.jp>
 
 	* dospecial.c, dvips.c, dvips.help, protos.h, resident.c:

Modified: trunk/Build/source/texk/dvipsk/NEWS
===================================================================
--- trunk/Build/source/texk/dvipsk/NEWS	2016-11-08 05:09:00 UTC (rev 42460)
+++ trunk/Build/source/texk/dvipsk/NEWS	2016-11-08 18:41:55 UTC (rev 42461)
@@ -1,5 +1,8 @@
 This file records noteworthy changes.  (Public domain.)
 
+  Make the last papersize special win, to match dvipdfmx; the -L0 option
+  or L0 config restores the previous behavior of the first special winning.
+  
 dvips 5.996 (TeX Live 2016).
   afm2tfm 8.4: only adjust heights of base characters upward for accent
   position, and new option -a to omit all adjustments.

Modified: trunk/Build/source/texk/dvipsk/dvips.info
===================================================================
--- trunk/Build/source/texk/dvipsk/dvips.info	2016-11-08 05:09:00 UTC (rev 42460)
+++ trunk/Build/source/texk/dvipsk/dvips.info	2016-11-08 18:41:55 UTC (rev 42461)
@@ -1,6 +1,7 @@
-This is dvips.info, produced by makeinfo version 6.1 from dvips.texi.
+This is dvips.info, produced by texi2any version 6.3dev+dev from
+dvips.texi.
 
-This manual documents Dvips version 5.996 (April 2016), a program to
+This manual documents Dvips version 5.996 (November 2016), a program to
 translate a DVI file into PostScript.  You may freely use, modify and/or
 distribute this file.
 INFO-DIR-SECTION TeX
@@ -16,7 +17,7 @@
 Dvips
 *****
 
-This manual documents Dvips version 5.996 (April 2016), a program to
+This manual documents Dvips version 5.996 (November 2016), a program to
 translate a DVI file into PostScript.  You may freely use, modify and/or
 distribute this file.
 
@@ -495,7 +496,7 @@
 -i*  Separate file per section
 -j*  Download fonts partially
 -k*  Print crop marks                -K*  Pull comments from inclusions
--l # Last page
+-l # Last page                       -L*  Last special papersize wins
 -m*  Manual feed                     -M*  Don't make fonts
 -mode s Metafont device name
 -n # Maximum number of pages         -N*  No structured comments
@@ -696,6 +697,10 @@
      file.  Thus, using '-l =9' will end with the ninth page of the
      document, no matter what the pages are actually numbered.
 
+'-L*'
+     By default or with '-L1', the last 'papersize' special wins; with
+     '-L0', the first special wins.  *Note papersize special::.
+
 '-m*'
      Specify manual feed, if supported by the output device.
 
@@ -1159,6 +1164,10 @@
      Remove comments from included PostScript files.  Same as '-K',
      *note Option details::.
 
+'L*'
+     If zero, the first paper size specified is effective, else the
+     last.  Same as '-L', *note Option details::.
+
 'm NUM'
      Declare NUM as the memory available for fonts and strings in the
      printer.  The compile-time default is 180000, but this is typically
@@ -1298,17 +1307,17 @@
 **************************************
 
 Most TeX documents at a particular site are designed to use the local
-standard paper size (letter size in the United States, A4 in Europe).
+standard paper size (letter size in the United States, A4 elsewhere).
 The Dvips program can be customized either sitewide or for a particular
 printer.
 
-   But many documents are designed for other paper sizes.  For instance,
-you may want to design a document that has the long edge of the paper
-horizontal.  This can be useful when typesetting booklets, brochures,
-complex tables, or many other documents.  This type of paper orientation
-is called "landscape" orientation (the default orientation is
-"portrait").  Alternatively, a document might be designed for ledger or
-A3 paper.
+   On the other hand, plenty of documents are designed for other paper
+sizes.  For instance, you may want to design a document that has the
+long edge of the paper horizontal.  This can be useful when typesetting
+booklets, brochures, complex tables, or many other documents.  This type
+of paper orientation is called "landscape" orientation (the default
+orientation is called "portrait").  Alternatively, a document might be
+designed for ledger or A3 paper.
 
    Since the intended paper size in these cases is a document design
 decision, not a printing decision, such information should be given in
@@ -1363,6 +1372,12 @@
    The 'papersize' special must occur somewhere on the first page of the
 document.  Some packages, notably 'hyperref', insert this special.
 
+   By default, if a DVI file contains multiple 'papersize' specials, the
+last one wins; this is also the behavior of the 'dvipdfmx' driver.  If
+the '-L0' command line option or 'L0' config file command is specified,
+the first special wins--this was the behavior of Dvips prior to the 2017
+release.
+
 
 File: dvips.info,  Node: Config file paper sizes,  Next: Paper trays,  Prev: papersize special,  Up: Paper size and landscape
 
@@ -3696,11 +3711,11 @@
 * Menu:
 
 * ! special (literal PS header):         Literal headers.     (line   6)
-* ! starting output filename:            Option details.      (line 238)
+* ! starting output filename:            Option details.      (line 242)
 * " special (literal PostScript):        " special.           (line   6)
 * %%BoundingBox:                         Bounding box.        (line  17)
 * %%Page, and multi-page information:    PostScript hooks.    (line  37)
-* %%Page, not generating:                Option details.      (line 203)
+* %%Page, not generating:                Option details.      (line 207)
 * %%Page, removing:                      Option details.      (line 160)
 * %%Page, required by Ghostview:         Ghostscript installation.
                                                               (line  12)
@@ -3709,9 +3724,9 @@
 * %*Font:                                Fonts in figures.    (line   6)
 * (atend), bounding box specification:   Bounding box.        (line  28)
 * +PSMAPFILE:                            Configuration file commands.
-                                                              (line 117)
+                                                              (line 121)
 * -:                                     Option details.      (line  11)
-* - as output filename:                  Option details.      (line 238)
+* - as output filename:                  Option details.      (line 242)
 * --help:                                Option summary.      (line   7)
 * --help <1>:                            Option details.      (line  15)
 * --version:                             Option details.      (line  18)
@@ -3736,55 +3751,56 @@
 * -j for partial font downloading:       Option details.      (line 146)
 * -K:                                    Option details.      (line 160)
 * -k for cropmarks:                      Option details.      (line 152)
+* -L:                                    Option details.      (line 178)
 * -l [=]NUM:                             Option details.      (line 169)
-* -m:                                    Option details.      (line 178)
-* -M:                                    Option details.      (line 190)
-* -mode:                                 Option details.      (line 181)
-* -mode MODE:                            Option details.      (line 181)
-* -N:                                    Option details.      (line 203)
-* -n NUM:                                Option details.      (line 200)
-* -noomega:                              Option details.      (line 211)
-* -noptex:                               Option details.      (line 217)
+* -m:                                    Option details.      (line 182)
+* -M:                                    Option details.      (line 194)
+* -mode:                                 Option details.      (line 185)
+* -mode MODE:                            Option details.      (line 185)
+* -N:                                    Option details.      (line 207)
+* -n NUM:                                Option details.      (line 204)
+* -noomega:                              Option details.      (line 215)
+* -noptex:                               Option details.      (line 221)
 * -O:                                    Afm2tfm options.     (line  51)
-* -o NAME:                               Option details.      (line 233)
-* -O X-OFFSET,Y-OFFSET:                  Option details.      (line 250)
-* -P PRINTER:                            Option details.      (line 282)
+* -o NAME:                               Option details.      (line 237)
+* -O X-OFFSET,Y-OFFSET:                  Option details.      (line 254)
+* -P PRINTER:                            Option details.      (line 286)
 * -p PS-ENC:                             Changing PostScript encodings.
                                                               (line   6)
 * -p PS-ENC <1>:                         Afm2tfm options.     (line  56)
-* -p [=]NUM:                             Option details.      (line 268)
-* -pp FIRST-LAST:                        Option details.      (line 277)
-* -pp RANGE:                             Option details.      (line 277)
+* -p [=]NUM:                             Option details.      (line 272)
+* -pp FIRST-LAST:                        Option details.      (line 281)
+* -pp RANGE:                             Option details.      (line 281)
 * -PPRINTER, and config file searching:  Configuration file searching.
                                                               (line  27)
-* -q:                                    Option details.      (line 301)
-* -r:                                    Option details.      (line 305)
-* -R:                                    Option details.      (line 308)
-* -s:                                    Option details.      (line 316)
-* -S NUM:                                Option details.      (line 323)
+* -q:                                    Option details.      (line 305)
+* -r:                                    Option details.      (line 309)
+* -R:                                    Option details.      (line 312)
+* -s:                                    Option details.      (line 320)
+* -S NUM:                                Option details.      (line 327)
 * -s SLANT:                              Afm2tfm options.     (line  61)
 * -T ENC-FILE:                           Changing both encodings.
                                                               (line   6)
-* -T HSIZE,VSIZE:                        Option details.      (line 348)
-* -t PAPERTYPE:                          Option details.      (line 328)
+* -T HSIZE,VSIZE:                        Option details.      (line 352)
+* -t PAPERTYPE:                          Option details.      (line 332)
 * -T PS-TEX-ENC:                         Afm2tfm options.     (line  71)
 * -t TEX-ENC:                            Changing TeX encodings.
                                                               (line   6)
 * -t TEX-ENC <1>:                        Afm2tfm options.     (line  66)
-* -U:                                    Option details.      (line 363)
+* -U:                                    Option details.      (line 367)
 * -u:                                    Afm2tfm options.     (line  75)
-* -u PSMAPFILE:                          Option details.      (line 355)
-* -v:                                    Option details.      (line 371)
-* -V:                                    Option details.      (line 374)
+* -u PSMAPFILE:                          Option details.      (line 359)
+* -v:                                    Option details.      (line 375)
+* -V:                                    Option details.      (line 378)
 * -v VPL-FILE:                           Afm2tfm options.     (line  81)
 * -V VPL-FILE:                           Afm2tfm options.     (line  84)
-* -x NUM:                                Option details.      (line 383)
-* -X NUM:                                Option details.      (line 391)
-* -Y NUM:                                Option details.      (line 398)
+* -x NUM:                                Option details.      (line 387)
+* -X NUM:                                Option details.      (line 395)
+* -Y NUM:                                Option details.      (line 402)
 * -z:                                    Hypertext.           (line   6)
-* -Z for compressing bitmap fonts:       Option details.      (line 407)
-* -z for recognizing hyperdvi:           Option details.      (line 401)
-* ..-relative filenames:                 Option details.      (line 308)
+* -Z for compressing bitmap fonts:       Option details.      (line 411)
+* -z for recognizing hyperdvi:           Option details.      (line 405)
+* ..-relative filenames:                 Option details.      (line 312)
 * .afm Adobe metric files:               Metric files.        (line  26)
 * .dvipsrc, searched for:                Configuration file searching.
                                                               (line  14)
@@ -3815,7 +3831,7 @@
 * <[ encoding vector downloading:        psfonts.map.         (line  36)
 * =: ligature operation:                 Encoding file format.
                                                               (line  59)
-* @ paper size config command:           Configuration file commands.
+* @ config command (define paper sizes): Configuration file commands.
                                                               (line  18)
 * \.:                                    Reencoding with Afm2tfm.
                                                               (line  43)
@@ -3836,20 +3852,20 @@
 * \magnification:                        EPSF scaling.        (line  62)
 * \rotninety:                            Literal examples.    (line  27)
 * \textCOLORNAME:                        Color macro files.   (line  45)
-* | starting output filename:            Option details.      (line 238)
-* a config command (memory conservation): Configuration file commands.
+* | starting output filename:            Option details.      (line 242)
+* a config command (conserve memory):    Configuration file commands.
                                                               (line  21)
 * A ring, Scandinavian letter:           Reencoding with Afm2tfm.
                                                               (line  32)
-* a3 papertype:                          Option details.      (line 328)
+* a3 papertype:                          Option details.      (line 332)
 * a4 paper size:                         Config file paper sizes.
                                                               (line  82)
-* a4 papertype:                          Option details.      (line 328)
+* a4 papertype:                          Option details.      (line 332)
 * A4size paper size:                     Config file paper sizes.
                                                               (line  90)
-* absolute filenames, disabling:         Option details.      (line 308)
+* absolute filenames, disabling:         Option details.      (line 312)
 * absolute page number, and -l:          Option details.      (line 169)
-* absolute page number, and -p:          Option details.      (line 268)
+* absolute page number, and -p:          Option details.      (line 272)
 * accent height adjustment, omitting:    Afm2tfm options.     (line  33)
 * accents, in wrong position:            Reencoding with Afm2tfm.
                                                               (line  32)
@@ -3887,7 +3903,7 @@
 * bop-hook:                              Paper trays.         (line   6)
 * bop-hook <1>:                          EPSF scaling.        (line  74)
 * bop-hook <2>:                          PostScript hooks.    (line  11)
-* bop-hook, and offset pages:            Option details.      (line 263)
+* bop-hook, and offset pages:            Option details.      (line 267)
 * boundary character:                    Encoding file format.
                                                               (line  41)
 * bounding box, comment for:             Bounding box.        (line   6)
@@ -3897,7 +3913,7 @@
 * bounding box, inaccurate:              EPSF clipping.       (line   6)
 * bounding box, supplying to TeX:        \includegraphics.    (line  36)
 * bounding box, supplying to TeX <1>:    EPSF macros.         (line  26)
-* c include additional config file:      Configuration file commands.
+* c config command (include another config file): Configuration file commands.
                                                               (line  27)
 * changing PostScript encodings:         Changing PostScript encodings.
                                                               (line   6)
@@ -3937,13 +3953,13 @@
 * compilation:                           Installation.        (line   6)
 * compressed PostScript:                 Dynamic creation of graphics.
                                                               (line   6)
-* compressing bitmap fonts:              Option details.      (line 407)
+* compressing bitmap fonts:              Option details.      (line 411)
 * Computer Modern in PostScript:         Hypertext caveats.   (line   6)
 * Computer Modern, encoding of:          Encodings.           (line  15)
 * condensed fonts:                       Afm2tfm options.     (line  47)
 * config.proto:                          config.ps installation.
                                                               (line  14)
-* config.ps:                             Option details.      (line 282)
+* config.ps:                             Option details.      (line 286)
 * config.ps installation:                config.ps installation.
                                                               (line   6)
 * config.ps paper sizes:                 Config file paper sizes.
@@ -3986,13 +4002,13 @@
 * debugging <1>:                         Option details.      (line  52)
 * debugging options:                     Debug options.       (line   6)
 * default resolutions:                   Configuration file commands.
-                                                              (line 138)
+                                                              (line 142)
 * default_texsizes Make variable:        Configuration file commands.
-                                                              (line 154)
+                                                              (line 158)
 * Deutsch, Peter:                        Ghostscript installation.
                                                               (line   6)
 * device dependency, and virtual fonts:  Configuration file commands.
-                                                              (line 177)
+                                                              (line 181)
 * dictionary, CharStrings:               PostScript typesetting.
                                                               (line  51)
 * dictionary, PostScript language:       PostScript typesetting.
@@ -3999,7 +4015,7 @@
                                                               (line  35)
 * dictionary, SDict:                     Literal headers.     (line   6)
 * dictionary, userdict:                  Header files.        (line  21)
-* distillation, and -z:                  Option details.      (line 401)
+* distillation, and -z:                  Option details.      (line 405)
 * distiller, for PDF files:              Hypertext.           (line  11)
 * dot accent:                            Reencoding with Afm2tfm.
                                                               (line  32)
@@ -4031,7 +4047,7 @@
 * DVIPSSIZES:                            Environment variables.
                                                               (line  46)
 * DVIPSSIZES, overrides R:               Configuration file commands.
-                                                              (line 151)
+                                                              (line 155)
 * dynamic creation of graphics:          Dynamic creation of graphics.
                                                               (line   6)
 * e config command (maxdrift):           Configuration file commands.
@@ -4089,14 +4105,14 @@
                                                               (line   6)
 * failure, to print at all:              No output.           (line   6)
 * fallback resolutions:                  Configuration file commands.
-                                                              (line 138)
+                                                              (line 142)
 * figures and fonts:                     Fonts in figures.    (line   6)
 * figures, natural size:                 EPSF macros.         (line  38)
 * figures, scaling:                      EPSF scaling.        (line   6)
 * filter, running as a:                  Option details.      (line  98)
-* first page printed:                    Option details.      (line 268)
+* first page printed:                    Option details.      (line 272)
 * font concepts:                         Font concepts.       (line   6)
-* font generation, avoiding:             Option details.      (line 190)
+* font generation, avoiding:             Option details.      (line 194)
 * fontinst:                              Invoking afm2tfm.    (line  13)
 * fonts, as header files:                Including headers from TeX.
                                                               (line  13)
@@ -4118,7 +4134,7 @@
                                                               (line  34)
 * fonts, system PostScript:              PostScript font installation.
                                                               (line  11)
-* G character shifting config command:   Configuration file commands.
+* G config command (character shifting): Configuration file commands.
                                                               (line  48)
 * gf files:                              Glyph files.         (line  41)
 * gftopk:                                Glyph files.         (line  41)
@@ -4130,7 +4146,7 @@
                                                               (line  12)
 * glyph files:                           Glyph files.         (line   6)
 * GLYPHFONTS, overrides P:               Configuration file commands.
-                                                              (line 126)
+                                                              (line 130)
 * gnuplot:                               Dynamic creation of graphics.
                                                               (line  25)
 * graphics inclusion fails:              Including graphics fails.
@@ -4138,10 +4154,10 @@
 * gs installation:                       Ghostscript installation.
                                                               (line   6)
 * gsave/grestore, and literal PS:        Literal examples.    (line  27)
-* gsftopk:                               Option details.      (line 375)
-* h header downloading config command:   Configuration file commands.
+* gsftopk:                               Option details.      (line 379)
+* h config command (download additional header): Configuration file commands.
                                                               (line  52)
-* H header path config command:          Configuration file commands.
+* H config command (PostScript header path): Configuration file commands.
                                                               (line  55)
 * Hafner, Jim:                           Color.               (line   6)
 * header file, downloading:              Option details.      (line 122)
@@ -4164,12 +4180,12 @@
 * hscale (psfile special option):        psfile special.      (line  30)
 * hsize (psfile special option):         psfile special.      (line  24)
 * html specials:                         Hypertext.           (line   6)
-* html specials, and -z:                 Option details.      (line 401)
+* html specials, and -z:                 Option details.      (line 405)
 * http://www.win.tue.nl/~dickie/idvi:    Hypertext.           (line  21)
 * http://xxx.lanl.gov/hypertex:          Hypertext.           (line  21)
 * Hungarian umlaut:                      Reencoding with Afm2tfm.
                                                               (line  32)
-* hyperdvi extensions, enabling:         Option details.      (line 401)
+* hyperdvi extensions, enabling:         Option details.      (line 405)
 * hypertext and bitmap fonts:            Hypertext caveats.   (line   6)
 * hypertext caveats:                     Hypertext caveats.   (line   6)
 * hypertext caveats <1>:                 Hypertext caveats.   (line   6)
@@ -4202,25 +4218,27 @@
                                                               (line  63)
 * Java DVI reader:                       Hypertext.           (line  21)
 * Jeffrey, Alan:                         Invoking afm2tfm.    (line  13)
-* K config command (comment-removal):    Configuration file commands.
+* K config command (comment removal):    Configuration file commands.
                                                               (line  67)
 * kerning, defined:                      Metric files.        (line  15)
 * KPATHSEA_DEBUG:                        Environment variables.
                                                               (line  18)
+* L config command (last paper size wins): Configuration file commands.
+                                                              (line  71)
 * landscape orientation, defined:        Paper size and landscape.
                                                               (line  11)
-* landscape papertype:                   Option details.      (line 328)
+* landscape papertype:                   Option details.      (line 332)
 * landscape, as \special:                papersize special.   (line  16)
 * last page printed:                     Option details.      (line 169)
 * last-resort font scaling, with DVIPSSIZES: Environment variables.
                                                               (line  47)
 * last-resort scaling, with R:           Configuration file commands.
-                                                              (line 138)
-* ledger papertype:                      Option details.      (line 328)
-* legal papertype:                       Option details.      (line 328)
+                                                              (line 142)
+* ledger papertype:                      Option details.      (line 332)
+* legal papertype:                       Option details.      (line 332)
 * letter paper size:                     Config file paper sizes.
                                                               (line  82)
-* letter papertype:                      Option details.      (line 328)
+* letter papertype:                      Option details.      (line 332)
 * letterhead tray:                       Paper trays.         (line  10)
 * letterSize paper size:                 Config file paper sizes.
                                                               (line  90)
@@ -4238,24 +4256,24 @@
 * lly (psfile special option):           psfile special.      (line  42)
 * long documents not printing:           Long documents fail. (line   6)
 * low characters, shifting:              Option details.      (line 117)
-* lpr spooler, MS-DOS emulation:         Option details.      (line 238)
+* lpr spooler, MS-DOS emulation:         Option details.      (line 242)
 * m config command (available memory):   Configuration file commands.
-                                                              (line  71)
+                                                              (line  75)
 * M config command (mf mode):            Configuration file commands.
-                                                              (line  98)
+                                                              (line 102)
 * macros for color:                      Color macro files.   (line   6)
 * macros for epsf inclusion:             \includegraphics.    (line   6)
 * macros for epsf inclusion <1>:         EPSF macros.         (line   6)
 * magnification, DVI:                    EPSF scaling.        (line  62)
-* magnification, overriding DVI:         Option details.      (line 383)
-* magnification, vertical:               Option details.      (line 394)
+* magnification, overriding DVI:         Option details.      (line 387)
+* magnification, vertical:               Option details.      (line 398)
 * mailcap and hypertext:                 Hypertext specials.  (line  53)
-* manual feed:                           Option details.      (line 178)
+* manual feed:                           Option details.      (line 182)
 * maxdrift:                              Option details.      (line  71)
-* maximum pages printed:                 Option details.      (line 200)
-* media:                                 Option details.      (line 328)
+* maximum pages printed:                 Option details.      (line 204)
+* media:                                 Option details.      (line 332)
 * memory available:                      Configuration file commands.
-                                                              (line  71)
+                                                              (line  75)
 * memory of printer exhausted:           Printer errors.      (line  14)
 * memory usage, and headers:             Headers and memory usage.
                                                               (line   6)
@@ -4264,26 +4282,26 @@
                                                               (line 104)
 * Metafont ligature operations:          Encoding file format.
                                                               (line  54)
-* Metafont mode, specifying:             Option details.      (line 181)
+* Metafont mode, specifying:             Option details.      (line 185)
 * Metafont source files:                 Glyph files.         (line  30)
 * metric files:                          Metric files.        (line   6)
 * Minion typeface family:                psfonts.map.         (line  60)
-* missfont.log:                          Option details.      (line 190)
-* MISSFONT_LOG:                          Option details.      (line 193)
+* missfont.log:                          Option details.      (line 194)
+* MISSFONT_LOG:                          Option details.      (line 197)
 * Mitsubishi Shinko CHC-S446i printer:   No output.           (line  14)
 * mkdvipspapers:                         Config file paper sizes.
                                                               (line  79)
-* mktexpk, avoiding:                     Option details.      (line 190)
+* mktexpk, avoiding:                     Option details.      (line 194)
 * mktexpk, changing name:                Environment variables.
                                                               (line  36)
-* mode name, specifying:                 Option details.      (line 181)
-* mtpk:                                  Option details.      (line 375)
+* mode name, specifying:                 Option details.      (line 185)
+* mtpk:                                  Option details.      (line 379)
 * multiple master fonts:                 psfonts.map.         (line  60)
 * multiple output files:                 Option details.      (line 127)
 * multiple paper trays:                  Paper trays.         (line   6)
 * Murphy, Tim:                           Hypertext specials.  (line  20)
-* N EPS-disabling config command:        Configuration file commands.
-                                                              (line 101)
+* N config command (disable EPS):        Configuration file commands.
+                                                              (line 105)
 * name:                                  Hypertext specials.  (line  41)
 * narrow fonts:                          psfonts.map.         (line  19)
 * no output at all:                      No output.           (line   6)
@@ -4291,16 +4309,16 @@
 * non-resident fonts:                    psfonts.map.         (line   6)
 * nopaper, paper format for -t:          Config file paper sizes.
                                                               (line  74)
-* O config command (offset):             Configuration file commands.
-                                                              (line 114)
-* o config command (output file):        Configuration file commands.
-                                                              (line 106)
+* o config command (output destination): Configuration file commands.
+                                                              (line 110)
+* O config command (page offsets):       Configuration file commands.
+                                                              (line 118)
 * oblique fonts:                         Special font effects.
                                                               (line   6)
 * octal character codes:                 Afm2tfm options.     (line  51)
 * odd pages only:                        Option details.      (line  27)
-* offset pages:                          Option details.      (line 250)
-* Omega extensions:                      Option details.      (line 211)
+* offset pages:                          Option details.      (line 254)
+* Omega extensions:                      Option details.      (line 215)
 * option, details of:                    Option details.      (line   6)
 * options, debugging:                    Debug options.       (line   6)
 * options, Dvips:                        Invoking Dvips.      (line   6)
@@ -4313,20 +4331,20 @@
 * output file, sectioning of:            Headers and memory usage.
                                                               (line   6)
 * output file, setting:                  Configuration file commands.
-                                                              (line 106)
+                                                              (line 110)
 * output files, multiple:                Option details.      (line 127)
 * output, inverted:                      Small or inverted.   (line   6)
 * output, none:                          No output.           (line   6)
-* output, redirecting:                   Option details.      (line 233)
+* output, redirecting:                   Option details.      (line 237)
 * output, too small:                     Small or inverted.   (line   6)
 * p config command (font aliases):       Configuration file commands.
-                                                              (line 117)
+                                                              (line 121)
 * P config command (PK path):            Configuration file commands.
-                                                              (line 126)
-* page range:                            Option details.      (line 277)
-* page, first printed:                   Option details.      (line 268)
+                                                              (line 130)
+* page range:                            Option details.      (line 281)
+* page, first printed:                   Option details.      (line 272)
 * page, last printed:                    Option details.      (line 169)
-* pages, maximum printed:                Option details.      (line 200)
+* pages, maximum printed:                Option details.      (line 204)
 * PaintType:                             Special font effects.
                                                               (line  50)
 * Pantone colors:                        Color macro files.   (line  16)
@@ -4337,15 +4355,16 @@
 * paper size, general:                   Paper size and landscape.
                                                               (line   6)
 * paper trays:                           Paper trays.         (line   6)
-* paper type:                            Option details.      (line 328)
+* paper type:                            Option details.      (line 332)
 * papersize special:                     papersize special.   (line   6)
-* papersize special, and no -t:          Option details.      (line 328)
+* papersize special, and no -t:          Option details.      (line 332)
+* papersize special, first vs. last:     Option details.      (line 178)
 * partial font downloading:              psfonts.map.         (line  55)
 * PDF files, font quality:               Hypertext caveats.   (line   6)
 * PDF files, making:                     Ghostscript installation.
                                                               (line   6)
 * PDF files, making <1>:                 Hypertext.           (line  11)
-* PDF files, option for:                 Option details.      (line 401)
+* PDF files, option for:                 Option details.      (line 405)
 * pdfmark:                               Hypertext.           (line   6)
 * pfa files:                             Glyph files.         (line  25)
 * pfb files:                             Glyph files.         (line  25)
@@ -4354,15 +4373,15 @@
 * Phaser printer, used for color calibration: Color device configuration.
                                                               (line  18)
 * physical page number, and -l:          Option details.      (line 169)
-* physical page number, and -p:          Option details.      (line 268)
+* physical page number, and -p:          Option details.      (line 272)
 * physical page number, and bop-hook:    PostScript hooks.    (line  26)
 * pipes, not readable:                   Option details.      (line  98)
 * pk files:                              Glyph files.         (line  35)
 * PKFONTS, overrides P:                  Configuration file commands.
-                                                              (line 126)
+                                                              (line 130)
 * plotfile, ps subspecial:               ps special.          (line  29)
 * pltotf:                                Metric files.        (line  39)
-* popen for output:                      Option details.      (line 238)
+* popen for output:                      Option details.      (line 242)
 * portrait orientation, defined:         Paper size and landscape.
                                                               (line  11)
 * positioning accuracy:                  Option details.      (line  71)
@@ -4372,9 +4391,9 @@
 * PostScript encoding:                   Encodings.           (line  27)
 * PostScript encoding, changing:         Changing PostScript encodings.
                                                               (line   6)
-* PostScript font alias file:            Option details.      (line 355)
+* PostScript font alias file:            Option details.      (line 359)
 * PostScript font alias file <1>:        Configuration file commands.
-                                                              (line 117)
+                                                              (line 121)
 * PostScript fonts:                      PostScript fonts.    (line   6)
 * PostScript fonts, installing:          PostScript font installation.
                                                               (line   6)
@@ -4400,9 +4419,9 @@
                                                               (line  14)
 * printer errors:                        Printer errors.      (line   6)
 * printer memory:                        Configuration file commands.
-                                                              (line  71)
+                                                              (line  75)
 * printer memory exhausted:              Printer errors.      (line  14)
-* printer offset:                        Option details.      (line 250)
+* printer offset:                        Option details.      (line 254)
 * PRINTER, and config file searching:    Configuration file searching.
                                                               (line  36)
 * PRINTER, avoided with -f:              Option details.      (line  98)
@@ -4420,18 +4439,18 @@
 * psfonts.map <2>:                       psfonts.map.         (line   6)
 * psheaderdir:                           Header files.        (line  12)
 * psi character missing:                 Hypertext caveats.   (line  54)
-* pstopk:                                Option details.      (line 375)
-* pTeX extensions:                       Option details.      (line 211)
-* pTeX extensions <1>:                   Option details.      (line 217)
+* pstopk:                                Option details.      (line 379)
+* pTeX extensions:                       Option details.      (line 215)
+* pTeX extensions <1>:                   Option details.      (line 221)
 * q config command (quiet):              Configuration file commands.
-                                                              (line 132)
+                                                              (line 136)
 * Q config command (quiet):              Configuration file commands.
-                                                              (line 132)
-* quiet operation:                       Option details.      (line 301)
+                                                              (line 136)
+* quiet operation:                       Option details.      (line 305)
+* R config command (fallback resolution): Configuration file commands.
+                                                              (line 142)
 * r config command (page reversal):      Configuration file commands.
-                                                              (line 135)
-* R fallback resolution config command:  Configuration file commands.
-                                                              (line 138)
+                                                              (line 139)
 * raw tfm files:                         Afm2tfm options.     (line  17)
 * reencode/*.enc:                        Encodings.           (line  35)
 * reencoding:                            Reencoding with Afm2tfm.
@@ -4442,25 +4461,25 @@
 * remapping:                             Reencoding with Afm2tfm.
                                                               (line   6)
 * resident fonts, different in different printers: Option details.
-                                                              (line 355)
+                                                              (line 359)
 * resident fonts, different in different printers <1>: Configuration file commands.
-                                                              (line 117)
-* resolution:                            Option details.      (line 391)
-* resolution <1>:                        Option details.      (line 398)
+                                                              (line 121)
+* resolution:                            Option details.      (line 395)
+* resolution <1>:                        Option details.      (line 402)
 * resolution, setting:                   Option details.      (line  58)
-* reverse pagination:                    Option details.      (line 305)
+* reverse pagination:                    Option details.      (line 309)
 * rhi (psfile special option):           psfile special.      (line  46)
 * Rokicki, Tomas:                        Why Dvips.           (line  60)
 * rotate.tex:                            ps special.          (line  33)
 * rwi (psfile special option):           psfile special.      (line  46)
+* s config command (global save/restore): Configuration file commands.
+                                                              (line 164)
 * S config command (pict path):          Configuration file commands.
-                                                              (line 163)
-* s config command (save/restore):       Configuration file commands.
-                                                              (line 160)
+                                                              (line 167)
 * save/restore, and inverted output:     Small or inverted.   (line   6)
 * save/restore, and literal PS:          Literal examples.    (line  27)
 * save/restore, and specials:            ps special.          (line   6)
-* save/restore, generating global:       Option details.      (line 316)
+* save/restore, generating global:       Option details.      (line 320)
 * scaleunit:                             psfile special.      (line  66)
 * scaling of figures:                    EPSF scaling.        (line   6)
 * scaling small caps:                    Afm2tfm options.     (line  43)
@@ -4475,14 +4494,14 @@
 * sections of output file, and memory:   Headers and memory usage.
                                                               (line   6)
 * sections output, in separate files:    Option details.      (line 127)
-* security:                              Option details.      (line 308)
-* shell command execution, disabling:    Option details.      (line 308)
+* security:                              Option details.      (line 312)
+* shell command execution, disabling:    Option details.      (line 312)
 * shell escape, in config file:          Configuration file commands.
                                                               (line  37)
 * Shinko CHC-S446i printer:              No output.           (line  14)
 * show PostScript operator:              PostScript typesetting.
                                                               (line  23)
-* silent operation:                      Option details.      (line 301)
+* silent operation:                      Option details.      (line 305)
 * simplex mode on duplex printers:       Including headers from the command line.
                                                               (line  13)
 * slanted fonts:                         Special font effects.
@@ -4497,21 +4516,21 @@
 * specials, hypertext:                   Hypertext specials.  (line   6)
 * splines:                               Glyph files.         (line  17)
 * spooler, lacking:                      Option details.      (line 110)
-* spooling to lpr on MS-DOS:             Option details.      (line 238)
+* spooling to lpr on MS-DOS:             Option details.      (line 242)
 * standard I/O:                          Option details.      (line  98)
 * standard input, reading options from:  Option details.      (line  11)
-* standard output, output to:            Option details.      (line 233)
+* standard output, output to:            Option details.      (line 237)
 * standard PostScript, required by Ghostview: Ghostscript installation.
                                                               (line  12)
 * start-hook:                            PostScript hooks.    (line  11)
-* structured comments:                   Option details.      (line 203)
+* structured comments:                   Option details.      (line 207)
 * system in config file:                 Configuration file commands.
                                                               (line  37)
 * T config command (TFM path):           Configuration file commands.
-                                                              (line 168)
+                                                              (line 172)
 * Tektronix Phaser printer, used for color calibration: Color device configuration.
                                                               (line  18)
-* testpage.tex:                          Option details.      (line 257)
+* testpage.tex:                          Option details.      (line 261)
 * TeX encoding, changing:                Changing TeX encodings.
                                                               (line   6)
 * TeX, including headers in:             Including headers from TeX.
@@ -4519,13 +4538,13 @@
 * TEXCONFIG:                             Environment variables.
                                                               (line  55)
 * TEXFONTS, overrides P:                 Configuration file commands.
-                                                              (line 126)
+                                                              (line 130)
 * TEXFONTS, overrides T:                 Configuration file commands.
-                                                              (line 168)
+                                                              (line 172)
 * TEXINPUTS, overrides S:                Configuration file commands.
-                                                              (line 163)
+                                                              (line 167)
 * texmext.enc:                           Encodings.           (line  35)
-* TEXMFOUTPUT:                           Option details.      (line 193)
+* TEXMFOUTPUT:                           Option details.      (line 197)
 * texmital.enc:                          Encodings.           (line  35)
 * texmsym.enc:                           Encodings.           (line  35)
 * texmsym.enc <1>:                       Changing TeX encodings.
@@ -4533,15 +4552,15 @@
 * TEXPICTS:                              Environment variables.
                                                               (line  62)
 * TEXPICTS, overrides S:                 Configuration file commands.
-                                                              (line 163)
+                                                              (line 167)
 * TEXPKS, overrides P:                   Configuration file commands.
-                                                              (line 126)
+                                                              (line 130)
 * TEXSIZES, overrides R:                 Configuration file commands.
-                                                              (line 151)
+                                                              (line 155)
 * text in figures, chopped off:          EPSF clipping.       (line   6)
 * tfm files:                             Metric files.        (line  31)
 * TFMFONTS, overrides T:                 Configuration file commands.
-                                                              (line 168)
+                                                              (line 172)
 * tftopl:                                Metric files.        (line  39)
 * Theisen, Tim:                          Ghostscript installation.
                                                               (line  12)
@@ -4550,7 +4569,7 @@
 * trademark character, accessing:        Changing PostScript encodings.
                                                               (line  18)
 * trailing spaces, dropped:              Hypertext caveats.   (line  54)
-* TranScript:                            Option details.      (line 203)
+* TranScript:                            Option details.      (line 207)
 * transforming downloaded fonts:         psfonts.map.         (line  19)
 * trouble:                               Diagnosing problems. (line   6)
 * Type 1 fonts:                          Glyph files.         (line  25)
@@ -4557,7 +4576,7 @@
 * typesetting in PostScript:             PostScript typesetting.
                                                               (line   6)
 * U config command (Xerox 4045):         Configuration file commands.
-                                                              (line 173)
+                                                              (line 177)
 * uncollated copies:                     Option details.      (line  41)
 * uncompressing PostScript:              Dynamic creation of graphics.
                                                               (line   6)
@@ -4575,12 +4594,12 @@
 * userdict, and dictionary files:        Header files.        (line  21)
 * userdict, used for header files:       Option details.      (line 122)
 * V config command (vf path):            Configuration file commands.
-                                                              (line 177)
+                                                              (line 181)
 * verbose EPSF processing:               EPSF macros.         (line  46)
 * vf files:                              Virtual fonts.       (line  16)
 * virtual font expansion:                Virtual fonts.       (line  33)
 * virtual font path:                     Configuration file commands.
-                                                              (line 177)
+                                                              (line 181)
 * virtual fonts:                         Virtual fonts.       (line   6)
 * virtual fonts, creating:               Invoking afm2tfm.    (line  13)
 * VM exhausted:                          Printer errors.      (line  14)
@@ -4592,102 +4611,102 @@
                                                               (line  52)
 * vscale (psfile special option):        psfile special.      (line  33)
 * vsize (psfile special option):         psfile special.      (line  27)
-* W config command (warning):            Configuration file commands.
-                                                              (line 182)
+* W config command (emit warning):       Configuration file commands.
+                                                              (line 186)
 * warning messages, defining:            Configuration file commands.
-                                                              (line 182)
-* warnings, suppressing:                 Option details.      (line 301)
+                                                              (line 186)
+* warnings, suppressing:                 Option details.      (line 305)
 * whole font downloading:                psfonts.map.         (line  60)
 * wide fonts:                            psfonts.map.         (line  19)
 * X config command (horizontal resolution): Configuration file commands.
-                                                              (line 189)
-* Xerox 4045:                            Option details.      (line 363)
+                                                              (line 193)
+* Xerox 4045:                            Option details.      (line 367)
 * Y config command (vertical resolution): Configuration file commands.
-                                                              (line 192)
-* Z config command (compression):        Configuration file commands.
-                                                              (line 195)
+                                                              (line 196)
+* Z config command (compress fonts):     Configuration file commands.
+                                                              (line 199)
 * z config command (secure mode):        Configuration file commands.
-                                                              (line 198)
+                                                              (line 202)
 
 
 
 Tag Table:
-Node: Top517
-Node: Why Dvips1263
-Node: Installation4280
-Node: config.ps installation5283
-Node: PostScript font installation7890
-Node: Ghostscript installation8810
-Node: Diagnosing problems9747
-Node: Debug options10838
-Node: No output11842
-Node: Small or inverted13308
-Node: Printer errors14026
-Node: Long documents fail15358
-Node: Including graphics fails15699
-Node: Invoking Dvips16938
-Node: Basic usage17560
-Node: Command-line options18564
-Node: Option summary19012
-Node: Option details21206
-Node: Environment variables40851
-Node: Config files43712
-Node: Configuration file searching44382
-Node: Configuration file commands47579
-Node: Paper size and landscape55236
-Node: papersize special56834
-Node: Config file paper sizes58243
-Node: Paper trays62399
-Node: Interaction with PostScript63733
-Node: PostScript figures64386
-Node: Bounding box65112
-Node: \includegraphics68484
-Node: EPSF macros70777
-Node: EPSF scaling72777
-Node: EPSF clipping75347
-Node: psfile special75989
-Node: Dynamic creation of graphics78381
-Node: Fonts in figures79699
-Node: Header files81349
-Node: Including headers from TeX82559
-Node: Including headers from the command line84597
-Node: Headers and memory usage85696
-Node: Literal PS86907
-Node: " special87489
-Node: ps special88230
-Node: Literal headers89728
-Node: PostScript hooks90437
-Node: Literal examples92533
-Node: Hypertext93987
-Node: Hypertext caveats95216
-Node: Hypertext specials99604
-Node: PostScript fonts102238
-Node: Font concepts103355
-Node: Metric files104522
-Node: Glyph files107302
-Node: Virtual fonts109661
-Node: Encodings111487
-Node: PostScript typesetting113890
-Node: Making a font available116975
-Node: Invoking afm2tfm122009
-Node: Changing font encodings123026
-Node: Changing TeX encodings123817
-Node: Changing PostScript encodings124919
-Node: Changing both encodings126263
-Node: Reencoding with Afm2tfm126937
-Node: Encoding file format130040
-Node: Special font effects134244
-Node: Afm2tfm options136504
-Node: psfonts.map140029
-Node: Color144759
-Node: Color macro files145803
-Node: User-definable colors148996
-Node: Color subtleties150272
-Node: Ted Turner151924
-Node: Color device configuration153149
-Node: Color support details155593
-Node: Color specifications155971
-Node: Color specials157375
-Node: Index159504
+Node: Top527
+Node: Why Dvips1276
+Node: Installation4293
+Node: config.ps installation5296
+Node: PostScript font installation7903
+Node: Ghostscript installation8823
+Node: Diagnosing problems9760
+Node: Debug options10851
+Node: No output11855
+Node: Small or inverted13321
+Node: Printer errors14039
+Node: Long documents fail15371
+Node: Including graphics fails15712
+Node: Invoking Dvips16951
+Node: Basic usage17573
+Node: Command-line options18577
+Node: Option summary19025
+Node: Option details21274
+Node: Environment variables41061
+Node: Config files43922
+Node: Configuration file searching44592
+Node: Configuration file commands47789
+Node: Paper size and landscape55570
+Node: papersize special57195
+Node: Config file paper sizes58903
+Node: Paper trays63059
+Node: Interaction with PostScript64393
+Node: PostScript figures65046
+Node: Bounding box65772
+Node: \includegraphics69144
+Node: EPSF macros71437
+Node: EPSF scaling73437
+Node: EPSF clipping76007
+Node: psfile special76649
+Node: Dynamic creation of graphics79041
+Node: Fonts in figures80359
+Node: Header files82009
+Node: Including headers from TeX83219
+Node: Including headers from the command line85257
+Node: Headers and memory usage86356
+Node: Literal PS87567
+Node: " special88149
+Node: ps special88890
+Node: Literal headers90388
+Node: PostScript hooks91097
+Node: Literal examples93193
+Node: Hypertext94647
+Node: Hypertext caveats95876
+Node: Hypertext specials100264
+Node: PostScript fonts102898
+Node: Font concepts104015
+Node: Metric files105182
+Node: Glyph files107962
+Node: Virtual fonts110321
+Node: Encodings112147
+Node: PostScript typesetting114550
+Node: Making a font available117635
+Node: Invoking afm2tfm122669
+Node: Changing font encodings123686
+Node: Changing TeX encodings124477
+Node: Changing PostScript encodings125579
+Node: Changing both encodings126923
+Node: Reencoding with Afm2tfm127597
+Node: Encoding file format130700
+Node: Special font effects134904
+Node: Afm2tfm options137164
+Node: psfonts.map140689
+Node: Color145419
+Node: Color macro files146463
+Node: User-definable colors149656
+Node: Color subtleties150932
+Node: Ted Turner152584
+Node: Color device configuration153809
+Node: Color support details156253
+Node: Color specifications156631
+Node: Color specials158035
+Node: Index160164
 
 End Tag Table

Modified: trunk/Build/source/texk/dvipsk/dvips.texi
===================================================================
--- trunk/Build/source/texk/dvipsk/dvips.texi	2016-11-08 05:09:00 UTC (rev 42460)
+++ trunk/Build/source/texk/dvipsk/dvips.texi	2016-11-08 18:41:55 UTC (rev 42461)
@@ -3,7 +3,7 @@
 @settitle Dvips: A DVI-to-PostScript translator
 
 @set version 5.996
- at set month-year April 2016
+ at set month-year November 2016
 
 @copying
 This manual documents Dvips version @value{version}
@@ -23,8 +23,6 @@
 @syncodeindex pg cp
 @syncodeindex vr cp
 
- at ifclear INSTALLONLY
-
 @dircategory TeX
 @direntry
 * DVI-to-Postscript: (dvips).        Translating TeX DVI files to PostScript.
@@ -126,10 +124,7 @@
 @cindex Rokicki, Tomas
 Tom Rokicki wrote and maintains the original Dvips program.
 
- at end ifclear
- at c INSTALLONLY
 
-
 @node Installation
 @chapter Installation
 
@@ -462,7 +457,6 @@
 (not ASCII hex) will probably fail with Dvips.
 
 
- at ifclear INSTALLONLY
 @node Invoking Dvips
 @chapter Invoking Dvips
 
@@ -782,6 +776,12 @@
 Thus, using @samp{-l =9} will end with the ninth page of the document,
 no matter what the pages are actually numbered.
 
+ at item -L*
+ at opindex -L
+ at cindex @samp{papersize} special, first vs.@: last
+By default or with @code{-L1}, the last @samp{papersize} special wins;
+with @code{-L0}, the first special wins.  @xref{@samp{papersize} special}.
+
 @item -m*
 @opindex -m
 @cindex manual feed
@@ -897,7 +897,7 @@
 @cindex offset pages
 @cindex printer offset
 Move the origin by @var{x-offset}, at var{y-offset}, a comma-separated
-pair of dimensions such as @samp{.1in,-.3cm} (@pxref{papersize
+pair of dimensions such as @samp{.1in,-.3cm} (@pxref{@samp{papersize}
 special}).  The origin of the page is shifted from the default position
 (of one inch down, one inch to the right from the upper left corner of
 the paper) by this amount.  This is usually best specified in the
@@ -1035,7 +1035,7 @@
 @item -T @var{hsize}, at var{vsize}
 @opindex -T @var{hsize}, at var{vsize}
 Set the paper size to (@var{hsize}, at var{vsize}), a comma-separated
-pair of dimensions such as @samp{.1in,-.3cm} (@pxref{papersize
+pair of dimensions such as @samp{.1in,-.3cm} (@pxref{@samp{papersize}
 special}).  It overrides any paper size special in the DVI file.  Be
 careful, as the paper size will stick to a predefined size if there is
 one close enough. To disable this behavior, use @samp{-tunknown}.
@@ -1327,11 +1327,11 @@
 
 @table @samp
 @item @@ @var{name hsize vsize}
- at opindex @@ @r{paper size config command}
+ at opindex @@ @r{config command (define paper sizes)}
 Define paper sizes.  @xref{Config file paper sizes}.
 
 @item a*
- at opindex a @r{config command (memory conservation)}
+ at opindex a @r{config command (conserve memory)}
 Memory conservation.  Same as @samp{-a}, @pxref{Option details}.
 
 @item b @var{#copies}
@@ -1339,7 +1339,7 @@
 Multiple copies.  Same as @samp{-b}, @pxref{Option details}.
 
 @item c @var{filename}
- at opindex c @r{include additional config file}
+ at opindex c @r{config command (include another config file)}
 Include @var{filename} as an additional configuration file, read
 immediately.
 
@@ -1368,16 +1368,16 @@
 Run as a filter.  Same as @samp{-f}, @pxref{Option details}.
 
 @item G*
- at opindex G @r{character shifting config command}
+ at opindex G @r{config command (character shifting)}
 Shift low-numbered characters; obsolete.  Same as @samp{-G},
 @pxref{Option details}.
 
 @item h @var{header}
- at opindex h @r{header downloading config command}
+ at opindex h @r{config command (download additional header)}
 Prepend @var{header} to output.  Same as @samp{h-}, @pxref{Option details}.
 
 @item H @var{path}
- at opindex H @r{header path config command}
+ at opindex H @r{config command (PostScript header path)}
 @cindex header path, defining
 @vindex DVIPSHEADERS at r{, overrides} H
 Use @var{path} to search for PostScript header files.  The environment
@@ -1393,10 +1393,15 @@
 Partially download Type 1 fonts.  Same as @samp{-j}, @pxref{Option details}.
 
 @item K*
- at opindex K @r{config command (comment-removal)}
+ at opindex K @r{config command (comment removal)}
 Remove comments from included PostScript files.  Same as @samp{-K},
 @pxref{Option details}.
 
+ at item L*
+ at opindex L @r{config command (last paper size wins)}
+If zero, the first paper size specified is effective, else the last.
+Same as @samp{-L}, @pxref{Option details}.
+
 @item m @var{num}
 @opindex m @r{config command (available memory)}
 @cindex memory available
@@ -1436,13 +1441,13 @@
 Metafont mode.  Same as @samp{-mode}, @pxref{Option details}.
 
 @item N*
- at opindex N @r{EPS-disabling config command}
+ at opindex N @r{ config command (disable EPS)}
 Disable structured comments.  Beware: This also turns off displaying
 page numbers or changing to specific pagenumbers in PostScript viewers.
 Same as @samp{-N}, @pxref{Option details}.
 
 @item o @var{name}
- at opindex o @r{config command (output file)}
+ at opindex o @r{config command (output destination)}
 @cindex output file, setting
 Send output to @var{name}.  Same as @samp{-o}, @pxref{Option details}.
 In the file @file{config.foo}, a setting like this is probably
@@ -1455,7 +1460,7 @@
 program by that name in the current directory or along the @code{PATH}.
 
 @item O @var{xoff}, at var{yoff}
- at opindex O @r{config command (offset)}
+ at opindex O @r{config command (page offsets)}
 Origin offset.  Same as @samp{-O}, @pxref{Option details}.
 
 @item p @r{[+]}@var{name}
@@ -1493,7 +1498,7 @@
 Page reversal.  Same as @samp{-r}, @pxref{Option details}.
 
 @item R @var{num1 num2 @dots{}}
- at opindex R @r{fallback resolution config command}
+ at opindex R @r{config command (fallback resolution)}
 @cindex fallback resolutions
 @cindex default resolutions
 @cindex last-resort scaling, with @code{R}
@@ -1521,7 +1526,7 @@
 @file{make/paths.make}.
 
 @item s*
- at opindex s @r{config command (save/restore)}
+ at opindex s @r{config command (global save/restore)}
 Output global save/restore.  Same as @samp{-s}, @pxref{Option details}.
 
 @item S @var{path}
@@ -1554,7 +1559,7 @@
 different devices.
 
 @item W @r{[@var{string}]}
- at opindex W @r{config command (warning)}
+ at opindex W @r{config command (emit warning)}
 @cindex warning messages, defining
 If @var{string} is supplied, write it to standard error after reading
 all the configuration files; with no @var{string}, cancel any previous
@@ -1571,7 +1576,7 @@
 Vertical resolution.  Same as @samp{-Y} (@pxref{Option details}).
 
 @item Z*
- at opindex Z @r{config command (compression)}
+ at opindex Z @r{config command (compress fonts)}
 Compress bitmap fonts.  Same as @samp{-Z} (@pxref{Option details}).
 
 @item z*
@@ -1589,19 +1594,19 @@
 @cindex paper size, general
 
 Most @TeX{} documents at a particular site are designed to use the
-local standard paper size (letter size in the United States, A4 in
-Europe).  The Dvips program can be customized either sitewide or for a
-particular printer.
+local standard paper size (letter size in the United States, A4
+elsewhere).  The Dvips program can be customized either sitewide or
+for a particular printer.
 
 @cindex landscape orientation, defined
 @cindex portrait orientation, defined
-But many documents are designed for other paper sizes.  For instance,
-you may want to design a document that has the long edge of the paper
-horizontal.  This can be useful when typesetting booklets, brochures,
-complex tables, or many other documents.  This type of paper orientation
-is called @dfn{landscape} orientation (the default orientation is
- at dfn{portrait}).  Alternatively, a document might be designed for ledger
-or A3 paper.
+On the other hand, plenty of documents are designed for other paper
+sizes.  For instance, you may want to design a document that has the
+long edge of the paper horizontal.  This can be useful when
+typesetting booklets, brochures, complex tables, or many other
+documents.  This type of paper orientation is called @dfn{landscape}
+orientation (the default orientation is called @dfn{portrait}).
+Alternatively, a document might be designed for ledger or A3 paper.
 
 Since the intended paper size in these cases is a document design
 decision, not a printing decision, such information should be given in
@@ -1615,13 +1620,13 @@
 not and should not attempt to override it manually.
 
 @menu
-* papersize special::           Specifying the paper size in TeX.
+* @samp{papersize} special::           Specifying the paper size in TeX.
 * Config file paper sizes::     Specifying printer- and site-specific sizes.
 * Paper trays::                 Changing paper trays automatically.
 @end menu
 
 
- at node papersize special
+ at node @samp{papersize} special
 @section @samp{papersize} special
 
 @findex papersize @r{special}
@@ -1640,7 +1645,7 @@
 unit), pc (picas), dd (didot points), and cc (ciceros).
 
 @findex landscape at r{, as @code{\special}}
-For a US letter size landscape document, the @code{papersize} would be:
+For a US letter size landscape document, the @samp{papersize} would be:
 @example
 \special@{papersize=11in,8.5in@}
 @end example
@@ -1653,7 +1658,7 @@
 
 @noindent
 This is supported for backward compatibility, but it is hoped that
-reventually the @code{papersize} comment will dominate.
+reventually the @samp{papersize} comment will dominate.
 
 Of course, such a @code{\special} only informs Dvips of the desired
 paper size; you must also adjust @code{\hsize} and @code{\vsize} in your
@@ -1660,15 +1665,21 @@
 @TeX{} document typeset to those dimensions.
 
 @findex unknown at r{, paper format for @samp{-t}}
-When using the @code{papersize} special, you generally should not also
+When using the @samp{papersize} special, you generally should not also
 specify @code{-t} on the command line (@pxref{Option details}).  The
 exception is when using a nonstandard paper size that isn't
 predefined; in this case, use @code{-t at tie{}unknown}.
 
-The @code{papersize} special must occur somewhere on the first page of
+The @samp{papersize} special must occur somewhere on the first page of
 the document.  Some packages, notably @samp{hyperref}, insert this special.
 
+By default, if a DVI file contains multiple @samp{papersize} specials,
+the last one wins; this is also the behavior of the @code{dvipdfmx}
+driver.  If the @code{-L0} command line option or @code{L0} config
+file command is specified, the first special wins---this was the
+behavior of Dvips prior to the 2017 release.
 
+
 @node Config file paper sizes
 @section Configuration file paper size command
 
@@ -4647,7 +4658,4 @@
 
 @printindex cp
 
-
- at end ifclear
- at c INSTALLONLY
 @bye



More information about the tex-live-commits mailing list