summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-11-08 18:41:55 +0000
committerKarl Berry <karl@freefriends.org>2016-11-08 18:41:55 +0000
commit789e2b335a864cfbc8690fc82b4f50f4049f6d0a (patch)
tree98ea0de59ab254aa60e050fa02b44e3ac439ec06
parenta83094a5b8d9e764da8eda645ce927f525f41c0a (diff)
document new papersize special behavior and options
git-svn-id: svn://tug.org/texlive/trunk@42461 c570f23f-e606-0410-a88d-b1316a301751
Diffstat
-rw-r--r--Build/source/texk/dvipsk/ChangeLog6
-rw-r--r--Build/source/texk/dvipsk/NEWS3
-rw-r--r--Build/source/texk/dvipsk/dvips.info507
-rw-r--r--Build/source/texk/dvipsk/dvips.texi92
4 files changed, 322 insertions, 286 deletions
diff --git a/Build/source/texk/dvipsk/ChangeLog b/Build/source/texk/dvipsk/ChangeLog
index df3eb9a158a..c5f40d2c94e 100644
--- a/Build/source/texk/dvipsk/ChangeLog
+++ b/Build/source/texk/dvipsk/ChangeLog
@@ -1,3 +1,9 @@
+2016-11-08 Karl Berry <karl@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@fuk.kindai.ac.jp>
* dospecial.c, dvips.c, dvips.help, protos.h, resident.c:
diff --git a/Build/source/texk/dvipsk/NEWS b/Build/source/texk/dvipsk/NEWS
index f6e1cece5d6..e96c13ae552 100644
--- a/Build/source/texk/dvipsk/NEWS
+++ b/Build/source/texk/dvipsk/NEWS
@@ -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.
diff --git a/Build/source/texk/dvipsk/dvips.info b/Build/source/texk/dvipsk/dvips.info
index 9b30dd5fa38..def6f7a5b38 100644
--- a/Build/source/texk/dvipsk/dvips.info
+++ b/Build/source/texk/dvipsk/dvips.info
@@ -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 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir)
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 @@ Options:
-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 @@ reversal, use '-r0'. Such options are marked with a trailing '*'.
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 @@ There is no provision for continuation lines.
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 @@ File: dvips.info, Node: Paper size and landscape, Next: Interaction with PostS
**************************************
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 @@ in this case, use '-t unknown'.
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 @@ Index
* 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 @@ Index
* %*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 @@ Index
* -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 @@ Index
* <[ 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 @@ Index
* \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 @@ Index
* 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 @@ Index
* 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 @@ Index
* 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,20 +4002,20 @@ Index
* 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.
(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 @@ Index
* 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 @@ Index
(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 @@ Index
(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 @@ Index
(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 @@ Index
* 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 @@ Index
* 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 @@ Index
(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 @@ Index
* 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 @@ Index
(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 @@ Index
* 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 @@ Index
* 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 @@ Index
* 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 @@ Index
* 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 @@ Index
* 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 @@ Index
(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 @@ Index
* 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 @@ Index
* 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 @@ Index
* 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 @@ Index
* 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 @@ Index
* 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 @@ Index
* 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,14 +4569,14 @@ Index
* 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)
* 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 @@ Index
* 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 @@ Index
(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
diff --git a/Build/source/texk/dvipsk/dvips.texi b/Build/source/texk/dvipsk/dvips.texi
index d658bb5b5a5..60dd066a7cb 100644
--- a/Build/source/texk/dvipsk/dvips.texi
+++ b/Build/source/texk/dvipsk/dvips.texi
@@ -3,7 +3,7 @@
@settitle Dvips: A DVI-to-PostScript translator
@set version 5.996
-@set month-year April 2016
+@set month-year November 2016
@copying
This manual documents Dvips version @value{version}
@@ -23,8 +23,6 @@ PostScript. You may freely use, modify and/or distribute this file.
@syncodeindex pg cp
@syncodeindex vr cp
-@ifclear INSTALLONLY
-
@dircategory TeX
@direntry
* DVI-to-Postscript: (dvips). Translating TeX DVI files to PostScript.
@@ -126,9 +124,6 @@ So if you don't use Dvips on your system, get it today.
@cindex Rokicki, Tomas
Tom Rokicki wrote and maintains the original Dvips program.
-@end ifclear
-@c INSTALLONLY
-
@node Installation
@chapter Installation
@@ -462,7 +457,6 @@ Any application which generates graphics output containing raw binary
(not ASCII hex) will probably fail with Dvips.
-@ifclear INSTALLONLY
@node Invoking Dvips
@chapter Invoking Dvips
@@ -782,6 +776,12 @@ compare with the @TeX{} @samp{\count0} values stored in the DVI file.
Thus, using @samp{-l =9} will end with the ninth page of the document,
no matter what the pages are actually numbered.
+@item -L*
+@opindex -L
+@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 @@ See the @samp{-f} option for how to override this.
@cindex offset pages
@cindex printer offset
Move the origin by @var{x-offset},@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 @@ you can use @samp{-E} to get pure EPSF output.)
@item -T @var{hsize},@var{vsize}
@opindex -T @var{hsize},@var{vsize}
Set the paper size to (@var{hsize},@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 @@ There is no provision for continuation lines.
@table @samp
@item @@ @var{name hsize vsize}
-@opindex @@ @r{paper size config command}
+@opindex @@ @r{config command (define paper sizes)}
Define paper sizes. @xref{Config file paper sizes}.
@item a*
-@opindex a @r{config command (memory conservation)}
+@opindex a @r{config command (conserve memory)}
Memory conservation. Same as @samp{-a}, @pxref{Option details}.
@item b @var{#copies}
@@ -1339,7 +1339,7 @@ Memory conservation. Same as @samp{-a}, @pxref{Option details}.
Multiple copies. Same as @samp{-b}, @pxref{Option details}.
@item c @var{filename}
-@opindex c @r{include additional config file}
+@opindex c @r{config command (include another config file)}
Include @var{filename} as an additional configuration file, read
immediately.
@@ -1368,16 +1368,16 @@ be printed if the option is used (and warnings are not suppressed).
Run as a filter. Same as @samp{-f}, @pxref{Option details}.
@item G*
-@opindex G @r{character shifting config command}
+@opindex G @r{config command (character shifting)}
Shift low-numbered characters; obsolete. Same as @samp{-G},
@pxref{Option details}.
@item h @var{header}
-@opindex h @r{header downloading config command}
+@opindex h @r{config command (download additional header)}
Prepend @var{header} to output. Same as @samp{h-}, @pxref{Option details}.
@item H @var{path}
-@opindex H @r{header path config command}
+@opindex H @r{config command (PostScript header path)}
@cindex header path, defining
@vindex DVIPSHEADERS@r{, overrides} H
Use @var{path} to search for PostScript header files. The environment
@@ -1393,10 +1393,15 @@ details}.
Partially download Type 1 fonts. Same as @samp{-j}, @pxref{Option details}.
@item K*
-@opindex K @r{config command (comment-removal)}
+@opindex K @r{config command (comment removal)}
Remove comments from included PostScript files. Same as @samp{-K},
@pxref{Option details}.
+@item L*
+@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 @@ splitting of the output is desirable. The Dvips config file
Metafont mode. Same as @samp{-mode}, @pxref{Option details}.
@item N*
-@opindex N @r{EPS-disabling config command}
+@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}
-@opindex o @r{config command (output file)}
+@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 @@ the local printer device @file{PRN} if it doesn't find an executable
program by that name in the current directory or along the @code{PATH}.
@item O @var{xoff},@var{yoff}
-@opindex O @r{config command (offset)}
+@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 @@ Run quietly. Same as @samp{-q}, @pxref{Option details}.
Page reversal. Same as @samp{-r}, @pxref{Option details}.
@item R @var{num1 num2 @dots{}}
-@opindex R @r{fallback resolution config command}
+@opindex R @r{config command (fallback resolution)}
@cindex fallback resolutions
@cindex default resolutions
@cindex last-resort scaling, with @code{R}
@@ -1521,7 +1526,7 @@ the Makefile variable @samp{default_texsizes}, defined in the file
@file{make/paths.make}.
@item s*
-@opindex s @r{config command (save/restore)}
+@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 @@ device-dependent if you use virtual fonts to simulate actual fonts on
different devices.
@item W @r{[@var{string}]}
-@opindex W @r{config command (warning)}
+@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 @@ Horizontal resolution. Same as @samp{-X} (@pxref{Option details}).
Vertical resolution. Same as @samp{-Y} (@pxref{Option details}).
@item Z*
-@opindex Z @r{config command (compression)}
+@opindex Z @r{config command (compress fonts)}
Compress bitmap fonts. Same as @samp{-Z} (@pxref{Option details}).
@item z*
@@ -1589,19 +1594,19 @@ on the command line, that takes precedence.
@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
-@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 @@ Some @LaTeX{} packages, e.g., @samp{hyperref.sty}, write a
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
-@node papersize special
+@node @samp{papersize} special
@section @samp{papersize} special
@findex papersize @r{special}
@@ -1640,7 +1645,7 @@ namely, in (inches), cm (centimeters), mm (millimeters), pt (points), sp
unit), pc (picas), dd (didot points), and cc (ciceros).
@findex landscape@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,21 +1658,27 @@ An alternate specification of @code{landscape}:
@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
@TeX{} document typeset to those dimensions.
@findex unknown@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@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 @@ categories of color-like state.
@printindex cp
-
-@end ifclear
-@c INSTALLONLY
@bye
generated by cgit v1.2.3 (git 2.39.1) at 2024-11-04 18:08:34 +0000