From a24dadb9faf6fd895d18977df4ef9030a024df1f Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 24 Oct 2021 17:32:33 +0000 Subject: describe .SEQ optional subvalue for -p and -l git-svn-id: svn://tug.org/texlive/trunk@60858 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/dvipsk/ChangeLog | 7 + Build/source/texk/dvipsk/dvips.1 | 33 ++- Build/source/texk/dvipsk/dvips.info | 411 ++++++++++++++++++------------------ Build/source/texk/dvipsk/dvips.texi | 43 ++-- 4 files changed, 252 insertions(+), 242 deletions(-) (limited to 'Build/source/texk/dvipsk') diff --git a/Build/source/texk/dvipsk/ChangeLog b/Build/source/texk/dvipsk/ChangeLog index 178d6738675..2660224d30f 100644 --- a/Build/source/texk/dvipsk/ChangeLog +++ b/Build/source/texk/dvipsk/ChangeLog @@ -1,3 +1,10 @@ +2021-10-24 Karl Berry + + * dvips.texi (Option details) <-l>: describe [.PAGESEQ] subvalue. + <-p>: Just refer to -l instead of duplicating. + * dvips.1: likewise. + Report from Igor Liferenko, 20 Aug 2021 10:13:32. + 2021-09-28 Karl Berry * dvips.texi (Option details) <-h>: mention that inclusion happens diff --git a/Build/source/texk/dvipsk/dvips.1 b/Build/source/texk/dvipsk/dvips.1 index 9825e2f1a56..e7cac8e2edb 100644 --- a/Build/source/texk/dvipsk/dvips.1 +++ b/Build/source/texk/dvipsk/dvips.1 @@ -1,4 +1,4 @@ -.TH DVIPS 1 "1 February 2016" +.TH DVIPS 1 "24 October 2021" .SH NAME dvips \- convert a TeX DVI file to PostScript .SH SYNOPSIS @@ -10,8 +10,7 @@ THIS MAN PAGE IS OBSOLETE! See the Texinfo documentation instead. You can read it either in Emacs or with the standalone .B info -program which comes with the GNU texinfo distribution as -ftp.gnu.org:pub/gnu/texinfo/texinfo*.tar.gz. +program. .PP The program .B dvips @@ -211,7 +210,13 @@ with values. Thus, using .I -l =9 will end with the ninth page of the document, no matter what the pages -are actually numbered. +are actually numbered. On the other hand, if +.I num +is suffixed by `.SEQ', the SEQth occurrence of +.I num +is used; for example, +.I -l 99.2 +says to end processing with the second page numbered 99 in the document. .TP .B -m Specify manual feed for printer. @@ -312,19 +317,9 @@ default position (of one inch down, one inch to the right from the upper left corner of the paper) by this amount. .TP .B -p num -The first page printed will be the first one numbered -.IR num . -Default is the first page in the document. If the -.I num -is prefixed by an equals sign, then it (and any argument to the +Just like .I -l -option) is treated as a sequence number, rather than a value to compare -with -.I \ecount0 -values. Thus, using -.I -p =3 -will start with the third page of the document, no matter what the pages -are actually numbered. +but for the first page in the document. .TP .B -pp pagelist A comma-separated list of pages and ranges (a-b) may be given, which @@ -512,9 +507,9 @@ information. Especially useful at high resolutions or when very large fonts are used. Will slow down printing somewhat, especially on early 68000-based PostScript printers. .SH "SEE ALSO" -mf(1), afm2tfm(1), tex(1), latex(1), lpr(1), +afm2tfm(1), tex(1), mf(1), dvitype(1), lpr(1), .IR dvips.texi , -http://tug.org/dvips. +https://tug.org/dvips. .SH ENVIRONMENT Dvipsk uses the same environment variables and algorithms for finding font files as TeX and its friends do. See the documentation for the @@ -531,4 +526,4 @@ by Don Knuth. Path searching and configuration modifications by Karl Berry. .PP Maintained in TeX Live; please send bug reports or other correspondence -to tex-k@tug.org (http://lists.tug.org/tex-k). +to tex-k@tug.org (https://lists.tug.org/tex-k). diff --git a/Build/source/texk/dvipsk/dvips.info b/Build/source/texk/dvipsk/dvips.info index 9077299ca0b..c52f5b5b9c4 100644 --- a/Build/source/texk/dvipsk/dvips.info +++ b/Build/source/texk/dvipsk/dvips.info @@ -1,8 +1,8 @@ This is dvips.info, produced by makeinfo version 6.8 from dvips.texi. -This manual documents Dvips version 2021.1 (September 2021), a program -to translate a DVI file into PostScript. You may freely use, modify -and/or distribute this file. +This manual documents Dvips version 2021.1 (October 2021), a program to +translate a DVI file into PostScript. You may freely use, modify and/or +distribute this file. INFO-DIR-SECTION TeX START-INFO-DIR-ENTRY * DVI-to-Postscript: (dvips). Translating TeX DVI files to PostScript. @@ -16,9 +16,9 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir) Dvips ***** -This manual documents Dvips version 2021.1 (September 2021), a program -to translate a DVI file into PostScript. You may freely use, modify -and/or distribute this file. +This manual documents Dvips version 2021.1 (October 2021), a program to +translate a DVI file into PostScript. You may freely use, modify and/or +distribute this file. * Menu: @@ -686,14 +686,21 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. header macros from some software packages read portion the input stream line by line, searching for a particular comment. -'-l [=]NUM' - The last page printed will be the first one numbered NUM. Default - is the last page in the document. If NUM is prefixed by an equals - sign, then it (and the argument to the '-p' option, if specified) - is treated as a physical (absolute) page number, rather than a - value to compare with the TeX '\count0' values stored in the DVI - file. Thus, using '-l =9' will end with the ninth page of the - document, no matter what the pages are actually numbered. +'-l [=]NUM[.PAGESEQ]' + The last page printed will be the first one numbered NUM; the + default is the last page in the document. + + By default, NUM is compared to TeX's idea of the page number (more + precisely, the '\count0' value written in the DVI file). But if + NUM is prefixed by an equals sign, then it (and the argument to the + '-p' option, if specified) is treated as a physical (absolute) page + number, Thus, using '-l =9' will end the output with the ninth page + of the document, no matter what the pages are actually numbered. + + On the other hand, if PAGESEQ is specified, the PAGESEQth + occurrence of the given TeX page number is used. For example, '-l + 99.2' says to end with the second page numbered 99 in the document. + The '=' and LASTSEQ features aren't useful together. '-L*' By default or with '-L1', the last 'papersize' special wins; with @@ -789,14 +796,9 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. every page, your best recourse is to use 'bop-hook' (*note PostScript hooks::). -'-p [=]NUM' - The first page printed will be the first one numbered NUM. Default - is the first page in the document. If NUM is prefixed by an equals - sign, then it (and the argument to the '-l' option, if specified) - is treated as a physical (absolute) page number, rather than a - value to compare with the TeX '\count0' values stored in the DVI - file. Thus, using '-p =3' will start with the third page of the - document, no matter what the pages are actually numbered. +'-p [=]NUM[.PAGESEQ]' + Exactly analogous to '-l' (q.v.), but specifying the first page + number to be printed (processed). '-pp FIRST-LAST' Print pages FIRST through LAST; equivalent to '-p FIRST -l LAST', @@ -3778,15 +3780,15 @@ Index * Menu: * ! special (literal PS header): Literal headers. (line 6) -* ! starting output filename: Option details. (line 249) +* ! starting output filename: Option details. (line 256) * " 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 214) +* %%Page, not generating: Option details. (line 221) * %%Page, removing: Option details. (line 167) * %%Page, required by Ghostview: Ghostscript installation. (line 12) -* %%Title: Option details. (line 359) +* %%Title: Option details. (line 361) * %%VMusage: Headers and memory usage. (line 12) * %*Font: Fonts in figures. (line 6) @@ -3794,7 +3796,7 @@ Index * +PSMAPFILE: Configuration file commands. (line 128) * -: Option details. (line 11) -* - as output filename: Option details. (line 249) +* - as output filename: Option details. (line 256) * --help: Option summary. (line 7) * --help <1>: Option details. (line 15) * --version: Option details. (line 18) @@ -3820,56 +3822,56 @@ Index * -j for partial font downloading: Option details. (line 153) * -K: Option details. (line 167) * -k for cropmarks: Option details. (line 159) -* -L: Option details. (line 185) -* -l [=]NUM: Option details. (line 176) -* -m: Option details. (line 189) -* -M: Option details. (line 201) -* -mode MODE: Option details. (line 192) -* -N: Option details. (line 214) -* -n NUM: Option details. (line 211) -* -noomega: Option details. (line 222) -* -noptex: Option details. (line 228) +* -L: Option details. (line 192) +* -l [=]NUM[.PAGESEQ]: Option details. (line 176) +* -m: Option details. (line 196) +* -M: Option details. (line 208) +* -mode MODE: Option details. (line 199) +* -N: Option details. (line 221) +* -n NUM: Option details. (line 218) +* -noomega: Option details. (line 229) +* -noptex: Option details. (line 235) * -O: Afm2tfm options. (line 51) -* -o NAME: Option details. (line 244) -* -O X-OFFSET,Y-OFFSET: Option details. (line 261) -* -P PRINTER: Option details. (line 293) +* -o NAME: Option details. (line 251) +* -O X-OFFSET,Y-OFFSET: Option details. (line 268) +* -P PRINTER: Option details. (line 295) * -p PS-ENC: Changing PostScript encodings. (line 6) * -p PS-ENC <1>: Afm2tfm options. (line 56) -* -p [=]NUM: Option details. (line 279) -* -pp FIRST-LAST: Option details. (line 288) -* -pp RANGE: Option details. (line 288) +* -p [=]NUM[.PAGESEQ]: Option details. (line 286) +* -pp FIRST-LAST: Option details. (line 290) +* -pp RANGE: Option details. (line 290) * -PPRINTER, and config file searching: Configuration file searching. (line 27) -* -q: Option details. (line 312) -* -r: Option details. (line 316) -* -R: Option details. (line 319) -* -s: Option details. (line 327) -* -S NUM: Option details. (line 334) +* -q: Option details. (line 314) +* -r: Option details. (line 318) +* -R: Option details. (line 321) +* -s: Option details. (line 329) +* -S NUM: Option details. (line 336) * -s SLANT: Afm2tfm options. (line 61) * -T ENC-FILE: Changing both encodings. (line 6) -* -T HSIZE,VSIZE: Option details. (line 365) -* -t PAPERTYPE: Option details. (line 339) +* -T HSIZE,VSIZE: Option details. (line 367) +* -t PAPERTYPE: Option details. (line 341) * -T PS-TEX-ENC: Afm2tfm options. (line 71) * -t TEX-ENC: Changing TeX encodings. (line 6) * -t TEX-ENC <1>: Afm2tfm options. (line 66) -* -title STR: Option details. (line 359) -* -U: Option details. (line 380) +* -title STR: Option details. (line 361) +* -U: Option details. (line 382) * -u: Afm2tfm options. (line 75) -* -u PSMAPFILE: Option details. (line 372) -* -v: Option details. (line 388) -* -V: Option details. (line 391) +* -u PSMAPFILE: Option details. (line 374) +* -v: Option details. (line 390) +* -V: Option details. (line 393) * -v VPL-FILE: Afm2tfm options. (line 81) * -V VPL-FILE: Afm2tfm options. (line 84) -* -x NUM: Option details. (line 400) -* -X NUM: Option details. (line 408) -* -Y NUM: Option details. (line 415) +* -x NUM: Option details. (line 402) +* -X NUM: Option details. (line 410) +* -Y NUM: Option details. (line 417) * -z: Hypertext. (line 6) -* -Z for compressing bitmap fonts: Option details. (line 424) -* -z for recognizing hyperdvi: Option details. (line 418) -* ..-relative filenames: Option details. (line 319) +* -Z for compressing bitmap fonts: Option details. (line 426) +* -z for recognizing hyperdvi: Option details. (line 420) +* ..-relative filenames: Option details. (line 321) * .afm Adobe metric files: Metric files. (line 26) * .dvipsrc, searched for: Configuration file searching. (line 14) @@ -3921,20 +3923,20 @@ Index * \magnification: EPSF scaling. (line 62) * \rotninety: Literal examples. (line 27) * \textCOLORNAME: Color macro files. (line 46) -* | starting output filename: Option details. (line 249) +* | starting output filename: Option details. (line 256) * a config command (conserve memory): Configuration file commands. (line 21) * A ring, Scandinavian letter: Reencoding with Afm2tfm. (line 32) -* a3 papertype: Option details. (line 339) +* a3 papertype: Option details. (line 341) * a4 paper size: Config file paper sizes. (line 82) -* a4 papertype: Option details. (line 339) +* a4 papertype: Option details. (line 341) * A4size paper size: Config file paper sizes. (line 90) -* absolute filenames, disabling: Option details. (line 319) +* absolute filenames, disabling: Option details. (line 321) * absolute page number, and -l: Option details. (line 176) -* absolute page number, and -p: Option details. (line 279) +* absolute page number, and -p: Option details. (line 286) * accent height adjustment, omitting: Afm2tfm options. (line 33) * accents, in wrong position: Reencoding with Afm2tfm. (line 32) @@ -3977,7 +3979,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 274) +* bop-hook, and offset pages: Option details. (line 281) * boundary character: Encoding file format. (line 41) * bounding box, comment for: Bounding box. (line 6) @@ -4029,13 +4031,13 @@ Index * compilation: Installation. (line 6) * compressed PostScript: Dynamic creation of graphics. (line 6) -* compressing bitmap fonts: Option details. (line 424) +* compressing bitmap fonts: Option details. (line 426) * 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 293) +* config.ps: Option details. (line 295) * config.ps installation: config.ps installation. (line 6) * config.ps paper sizes: Config file paper sizes. @@ -4093,9 +4095,9 @@ Index (line 35) * dictionary, SDict: Literal headers. (line 6) * dictionary, userdict: Header files. (line 21) -* distillation, and -z: Option details. (line 418) +* distillation, and -z: Option details. (line 420) * distiller, for PDF files: Hypertext. (line 11) -* document title, specifying: Option details. (line 359) +* document title, specifying: Option details. (line 361) * dot accent: Reencoding with Afm2tfm. (line 32) * double-sided printing: Option details. (line 37) @@ -4193,11 +4195,11 @@ Index * figures, natural size: EPSF macros. (line 38) * figures, scaling: EPSF scaling. (line 6) * filter, running as a: Option details. (line 103) -* first page printed: Option details. (line 279) +* first page printed: Option details. (line 286) * font concepts: Font concepts. (line 6) * font encodings, bitmap: Bitmap font encodings. (line 6) -* font generation, avoiding: Option details. (line 201) +* font generation, avoiding: Option details. (line 208) * fontinst: Invoking afm2tfm. (line 13) * fonts, as header files: Including headers from TeX. (line 13) @@ -4239,7 +4241,7 @@ Index * gs installation: Ghostscript installation. (line 6) * gsave/grestore, and literal PS: Literal examples. (line 27) -* gsftopk: Option details. (line 392) +* gsftopk: Option details. (line 394) * h config command (download additional header): Configuration file commands. (line 57) * H config command (PostScript header path): Configuration file commands. @@ -4265,11 +4267,11 @@ 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 418) +* html specials, and -z: Option details. (line 420) * http://xxx.lanl.gov/hypertex: Hypertext. (line 22) * Hungarian umlaut: Reencoding with Afm2tfm. (line 32) -* hyperdvi extensions, enabling: Option details. (line 418) +* hyperdvi extensions, enabling: Option details. (line 420) * hypertext and bitmap fonts: Hypertext caveats. (line 6) * hypertext caveats: Hypertext caveats. (line 6) * hypertext caveats <1>: Hypertext caveats. (line 6) @@ -4311,18 +4313,18 @@ Index (line 78) * landscape orientation, defined: Paper size and landscape. (line 11) -* landscape papertype: Option details. (line 339) +* landscape papertype: Option details. (line 341) * landscape, as \special: papersize special. (line 16) * last page printed: Option details. (line 176) * last-resort font scaling, with DVIPSSIZES: Environment variables. (line 47) * last-resort scaling, with R: Configuration file commands. (line 149) -* ledger papertype: Option details. (line 339) -* legal papertype: Option details. (line 339) +* ledger papertype: Option details. (line 341) +* legal papertype: Option details. (line 341) * letter paper size: Config file paper sizes. (line 82) -* letter papertype: Option details. (line 339) +* letter papertype: Option details. (line 341) * letterhead tray: Paper trays. (line 10) * letterSize paper size: Config file paper sizes. (line 90) @@ -4340,7 +4342,7 @@ Index * lly (psfile special option): psfile special. (line 42) * long documents not printing: Long documents fail. (line 6) * low characters, shifting: Option details. (line 122) -* lpr spooler, MS-DOS emulation: Option details. (line 249) +* lpr spooler, MS-DOS emulation: Option details. (line 256) * m config command (available memory): Configuration file commands. (line 82) * M config command (mf mode): Configuration file commands. @@ -4349,13 +4351,13 @@ Index * 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 400) -* magnification, vertical: Option details. (line 411) +* magnification, overriding DVI: Option details. (line 402) +* magnification, vertical: Option details. (line 413) * mailcap and hypertext: Hypertext specials. (line 53) -* manual feed: Option details. (line 189) +* manual feed: Option details. (line 196) * maxdrift: Option details. (line 76) -* maximum pages printed: Option details. (line 211) -* media: Option details. (line 339) +* maximum pages printed: Option details. (line 218) +* media: Option details. (line 341) * memory available: Configuration file commands. (line 82) * memory of printer exhausted: Printer errors. (line 14) @@ -4366,20 +4368,20 @@ Index (line 104) * Metafont ligature operations: Encoding file format. (line 54) -* Metafont mode, specifying: Option details. (line 192) +* Metafont mode, specifying: Option details. (line 199) * 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 201) -* MISSFONT_LOG: Option details. (line 204) +* missfont.log: Option details. (line 208) +* MISSFONT_LOG: Option details. (line 211) * Mitsubishi Shinko CHC-S446i printer: No output. (line 14) * mkdvipspapers: Config file paper sizes. (line 79) -* mktexpk, avoiding: Option details. (line 201) +* mktexpk, avoiding: Option details. (line 208) * mktexpk, changing name: Environment variables. (line 36) -* mode name, specifying: Option details. (line 192) -* mtpk: Option details. (line 392) +* mode name, specifying: Option details. (line 199) +* mtpk: Option details. (line 394) * multiple master fonts: psfonts.map. (line 60) * multiple output files: Option details. (line 134) * multiple paper trays: Paper trays. (line 6) @@ -4401,8 +4403,8 @@ Index (line 6) * octal character codes: Afm2tfm options. (line 51) * odd pages only: Option details. (line 27) -* offset pages: Option details. (line 261) -* Omega extensions: Option details. (line 222) +* offset pages: Option details. (line 268) +* Omega extensions: Option details. (line 229) * option, details of: Option details. (line 6) * options, debugging: Debug options. (line 6) * options, Dvips: Invoking Dvips. (line 6) @@ -4417,19 +4419,20 @@ Index * output file, setting: Configuration file commands. (line 117) * output files, multiple: Option details. (line 134) -* output title, specifying: Option details. (line 359) +* output title, specifying: Option details. (line 361) * output, inverted: Small or inverted. (line 6) * output, none: No output. (line 6) -* output, redirecting: Option details. (line 244) +* output, redirecting: Option details. (line 251) * output, too small: Small or inverted. (line 6) * p config command (font aliases): Configuration file commands. (line 128) * P config command (PK path): Configuration file commands. (line 137) -* page range: Option details. (line 288) -* page, first printed: Option details. (line 279) +* page numbers, multiple repetitions of: Option details. (line 176) +* page range: Option details. (line 290) +* page, first printed: Option details. (line 286) * page, last printed: Option details. (line 176) -* pages, maximum printed: Option details. (line 211) +* pages, maximum printed: Option details. (line 218) * PaintType: Special font effects. (line 50) * Pantone colors: Color macro files. (line 17) @@ -4440,16 +4443,16 @@ Index * paper size, general: Paper size and landscape. (line 6) * paper trays: Paper trays. (line 6) -* paper type: Option details. (line 339) +* paper type: Option details. (line 341) * papersize special: papersize special. (line 6) -* papersize special, and no -t: Option details. (line 339) -* papersize special, first vs. last: Option details. (line 185) +* papersize special, and no -t: Option details. (line 341) +* papersize special, first vs. last: Option details. (line 192) * 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 418) +* PDF files, option for: Option details. (line 420) * pdfmark: Hypertext. (line 6) * pfa files: Glyph files. (line 25) * pfb files: Glyph files. (line 25) @@ -4458,7 +4461,7 @@ Index * Phaser printer, used for color calibration: Color device configuration. (line 18) * physical page number, and -l: Option details. (line 176) -* physical page number, and -p: Option details. (line 279) +* physical page number, and -p: Option details. (line 286) * physical page number, and bop-hook: PostScript hooks. (line 26) * pipes, not readable: Option details. (line 103) * pk files: Glyph files. (line 35) @@ -4466,7 +4469,7 @@ Index (line 137) * plotfile, ps subspecial: ps special. (line 29) * pltotf: Metric files. (line 39) -* popen for output: Option details. (line 249) +* popen for output: Option details. (line 256) * portrait orientation, defined: Paper size and landscape. (line 11) * positioning accuracy: Option details. (line 76) @@ -4476,7 +4479,7 @@ Index * PostScript encoding: Encodings. (line 27) * PostScript encoding, changing: Changing PostScript encodings. (line 6) -* PostScript font alias file: Option details. (line 372) +* PostScript font alias file: Option details. (line 374) * PostScript font alias file <1>: Configuration file commands. (line 128) * PostScript fonts: PostScript fonts. (line 6) @@ -4506,7 +4509,7 @@ Index * printer memory: Configuration file commands. (line 82) * printer memory exhausted: Printer errors. (line 14) -* printer offset: Option details. (line 261) +* printer offset: Option details. (line 268) * PRINTER, and config file searching: Configuration file searching. (line 36) * PRINTER, avoided with -f: Option details. (line 103) @@ -4524,15 +4527,15 @@ Index * psfonts.map <2>: psfonts.map. (line 6) * psheaderdir: Header files. (line 12) * psi character missing: Hypertext caveats. (line 53) -* pstopk: Option details. (line 392) -* pTeX extensions: Option details. (line 222) -* pTeX extensions <1>: Option details. (line 228) +* pstopk: Option details. (line 394) +* pTeX extensions: Option details. (line 229) +* pTeX extensions <1>: Option details. (line 235) * ptex JFM: Virtual fonts. (line 37) * q config command (quiet): Configuration file commands. (line 143) * Q config command (quiet): Configuration file commands. (line 143) -* quiet operation: Option details. (line 312) +* quiet operation: Option details. (line 314) * R config command (fallback resolution): Configuration file commands. (line 149) * r config command (page reversal): Configuration file commands. @@ -4547,13 +4550,13 @@ Index * remapping: Reencoding with Afm2tfm. (line 6) * resident fonts, different in different printers: Option details. - (line 372) + (line 374) * resident fonts, different in different printers <1>: Configuration file commands. (line 128) -* resolution: Option details. (line 408) -* resolution <1>: Option details. (line 415) +* resolution: Option details. (line 410) +* resolution <1>: Option details. (line 417) * resolution, setting: Option details. (line 63) -* reverse pagination: Option details. (line 316) +* reverse pagination: Option details. (line 318) * rhi (psfile special option): psfile special. (line 46) * Rokicki, Tomas: Why Dvips. (line 52) * rotate.tex: ps special. (line 33) @@ -4565,7 +4568,7 @@ Index * 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 327) +* save/restore, generating global: Option details. (line 329) * scaleunit: psfile special. (line 66) * scaling of figures: EPSF scaling. (line 6) * scaling small caps: Afm2tfm options. (line 43) @@ -4580,14 +4583,14 @@ Index * sections of output file, and memory: Headers and memory usage. (line 6) * sections output, in separate files: Option details. (line 134) -* security: Option details. (line 319) -* shell command execution, disabling: Option details. (line 319) +* security: Option details. (line 321) +* shell command execution, disabling: Option details. (line 321) * shell escape, in config file: Configuration file commands. (line 42) * Shinko CHC-S446i printer: No output. (line 14) * show PostScript operator: PostScript typesetting. (line 23) -* silent operation: Option details. (line 312) +* silent operation: Option details. (line 314) * simplex mode on duplex printers: Including headers from the command line. (line 13) * slanted fonts: Special font effects. @@ -4602,21 +4605,21 @@ Index * specials, hypertext: Hypertext specials. (line 6) * splines: Glyph files. (line 17) * spooler, lacking: Option details. (line 115) -* spooling to lpr on MS-DOS: Option details. (line 249) +* spooling to lpr on MS-DOS: Option details. (line 256) * standard I/O: Option details. (line 103) * standard input, reading options from: Option details. (line 11) -* standard output, output to: Option details. (line 244) +* standard output, output to: Option details. (line 251) * standard PostScript, required by Ghostview: Ghostscript installation. (line 12) * start-hook: PostScript hooks. (line 11) -* structured comments: Option details. (line 214) +* structured comments: Option details. (line 221) * system in config file: Configuration file commands. (line 42) * T config command (TFM path): Configuration file commands. (line 179) * Tektronix Phaser printer, used for color calibration: Color device configuration. (line 18) -* testpage.tex: Option details. (line 268) +* testpage.tex: Option details. (line 275) * TeX encoding, changing: Changing TeX encodings. (line 6) * TeX, including headers in: Including headers from TeX. @@ -4630,7 +4633,7 @@ Index * TEXINPUTS, overrides S: Configuration file commands. (line 174) * texmext.enc: Encodings. (line 35) -* TEXMFOUTPUT: Option details. (line 204) +* TEXMFOUTPUT: Option details. (line 211) * texmital.enc: Encodings. (line 35) * texmsym.enc: Encodings. (line 35) * texmsym.enc <1>: Changing TeX encodings. @@ -4651,12 +4654,12 @@ Index * Theisen, Tim: Ghostscript installation. (line 12) * tight bounding box, finding: Option details. (line 87) -* title, specifying: Option details. (line 359) +* title, specifying: Option details. (line 361) * too-small output: Small or inverted. (line 6) * trademark character, accessing: Changing PostScript encodings. (line 18) * trailing spaces, dropped: Hypertext caveats. (line 53) -* TranScript: Option details. (line 214) +* TranScript: Option details. (line 221) * transforming downloaded fonts: psfonts.map. (line 19) * trouble: Diagnosing problems. (line 6) * Type 1 fonts: Glyph files. (line 25) @@ -4703,12 +4706,12 @@ Index (line 193) * warning messages, defining: Configuration file commands. (line 193) -* warnings, suppressing: Option details. (line 312) +* warnings, suppressing: Option details. (line 314) * whole font downloading: psfonts.map. (line 60) * wide fonts: psfonts.map. (line 19) * X config command (horizontal resolution): Configuration file commands. (line 200) -* Xerox 4045: Option details. (line 380) +* Xerox 4045: Option details. (line 382) * Y config command (vertical resolution): Configuration file commands. (line 203) * Z config command (compress fonts): Configuration file commands. @@ -4719,84 +4722,84 @@ Index  Tag Table: -Node: Top522 -Node: Why Dvips1273 -Node: Installation3856 -Node: config.ps installation4791 -Node: PostScript font installation7398 -Node: Ghostscript installation8318 -Node: Diagnosing problems9257 -Node: Debug options10348 -Node: No output11352 -Node: Small or inverted12818 -Node: Printer errors13536 -Node: Long documents fail14868 -Node: Including graphics fails15209 -Node: Invoking Dvips16448 -Node: Basic usage17039 -Node: Command-line options18037 -Node: Option summary18485 -Node: Option details20760 -Node: Environment variables41077 -Node: Config files43938 -Node: Configuration file searching44608 -Node: Configuration file commands47805 -Node: Paper size and landscape55875 -Node: papersize special57500 -Node: Config file paper sizes59208 -Node: Paper trays63364 -Node: Interaction with PostScript64698 -Node: PostScript figures65351 -Node: Bounding box66077 -Node: \includegraphics69449 -Node: EPSF macros71741 -Node: EPSF scaling73709 -Node: EPSF clipping76279 -Node: psfile special76921 -Node: Dynamic creation of graphics79313 -Node: Fonts in figures80631 -Node: Header files82281 -Node: Including headers from TeX83487 -Node: Including headers from the command line85525 -Node: Headers and memory usage86624 -Node: Literal PS87835 -Node: " special88417 -Node: ps special89158 -Node: Literal headers90656 -Node: PostScript hooks91365 -Node: Literal examples93461 -Node: Hypertext94915 -Node: Hypertext caveats96089 -Node: Hypertext specials100445 -Node: PostScript fonts103079 -Node: Font concepts104196 -Node: Metric files105426 -Node: Glyph files108206 -Node: Virtual fonts110565 -Node: Encodings112720 -Node: Bitmap font encodings115122 -Node: PostScript typesetting117652 -Node: Making a font available120749 -Node: Invoking afm2tfm125783 -Node: Changing font encodings126803 -Node: Changing TeX encodings127594 -Node: Changing PostScript encodings128696 -Node: Changing both encodings130040 -Node: Reencoding with Afm2tfm130714 -Node: Encoding file format133817 -Node: Special font effects138021 -Node: Afm2tfm options140281 -Node: psfonts.map143806 -Node: Color148536 -Node: Color macro files149580 -Node: User-definable colors152790 -Node: Color subtleties154066 -Node: Ted Turner155718 -Node: Color device configuration156943 -Node: Color support details159387 -Node: Color specifications159765 -Node: Color specials161169 -Node: Index163298 +Node: Top520 +Node: Why Dvips1269 +Node: Installation3852 +Node: config.ps installation4787 +Node: PostScript font installation7394 +Node: Ghostscript installation8314 +Node: Diagnosing problems9253 +Node: Debug options10344 +Node: No output11348 +Node: Small or inverted12814 +Node: Printer errors13532 +Node: Long documents fail14864 +Node: Including graphics fails15205 +Node: Invoking Dvips16444 +Node: Basic usage17035 +Node: Command-line options18033 +Node: Option summary18481 +Node: Option details20756 +Node: Environment variables41042 +Node: Config files43903 +Node: Configuration file searching44573 +Node: Configuration file commands47770 +Node: Paper size and landscape55840 +Node: papersize special57465 +Node: Config file paper sizes59173 +Node: Paper trays63329 +Node: Interaction with PostScript64663 +Node: PostScript figures65316 +Node: Bounding box66042 +Node: \includegraphics69414 +Node: EPSF macros71706 +Node: EPSF scaling73674 +Node: EPSF clipping76244 +Node: psfile special76886 +Node: Dynamic creation of graphics79278 +Node: Fonts in figures80596 +Node: Header files82246 +Node: Including headers from TeX83452 +Node: Including headers from the command line85490 +Node: Headers and memory usage86589 +Node: Literal PS87800 +Node: " special88382 +Node: ps special89123 +Node: Literal headers90621 +Node: PostScript hooks91330 +Node: Literal examples93426 +Node: Hypertext94880 +Node: Hypertext caveats96054 +Node: Hypertext specials100410 +Node: PostScript fonts103044 +Node: Font concepts104161 +Node: Metric files105391 +Node: Glyph files108171 +Node: Virtual fonts110530 +Node: Encodings112685 +Node: Bitmap font encodings115087 +Node: PostScript typesetting117617 +Node: Making a font available120714 +Node: Invoking afm2tfm125748 +Node: Changing font encodings126768 +Node: Changing TeX encodings127559 +Node: Changing PostScript encodings128661 +Node: Changing both encodings130005 +Node: Reencoding with Afm2tfm130679 +Node: Encoding file format133782 +Node: Special font effects137986 +Node: Afm2tfm options140246 +Node: psfonts.map143771 +Node: Color148501 +Node: Color macro files149545 +Node: User-definable colors152755 +Node: Color subtleties154031 +Node: Ted Turner155683 +Node: Color device configuration156908 +Node: Color support details159352 +Node: Color specifications159730 +Node: Color specials161134 +Node: Index163263  End Tag Table diff --git a/Build/source/texk/dvipsk/dvips.texi b/Build/source/texk/dvipsk/dvips.texi index 897bb6723ba..652ad51a88f 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 2021.1 -@set month-year September 2021 +@set month-year October 2021 @copying This manual documents Dvips version @value{version} @@ -763,19 +763,29 @@ cause other graphics to fail, however, since the PostScript header macros from some software packages read portion the input stream line by line, searching for a particular comment. -@item -l [=]@var{num} -@opindex -l [=]@var{num} +@item -l [=]@var{num}[.@var{pageseq}] +@opindex -l [=]@var{num}[.@var{pageseq}] @cindex last page printed @cindex page, last printed +@cindex page numbers, multiple repetitions of @cindex physical page number, and @samp{-l} @cindex absolute page number, and @samp{-l} -The last page printed will be the first one numbered @var{num}. Default -is the last page in the document. If @var{num} is prefixed by an equals -sign, then it (and the argument to the @samp{-p} option, if specified) -is treated as a physical (absolute) page number, rather than a value to -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. +The last page printed will be the first one numbered @var{num}; the +default is the last page in the document. + +By default, @var{num} is compared to @TeX{}'s idea of the page number +(more precisely, the @code{\count0} value written in the DVI file). +But if @var{num} is prefixed by an equals sign, then it (and the +argument to the @samp{-p} option, if specified) is treated as a +physical (absolute) page number, Thus, using @samp{-l =9} will end the +output with the ninth page of the document, no matter what the pages +are actually numbered. + +On the other hand, if @var{pageseq} is specified, the @var{pageseq}th +occurrence of the given @TeX{} page number is used. For example, +@samp{-l 99.2} says to end with the second page numbered 99 in the +document. The @samp{=} and @var{lastseq} features aren't useful +together. @item -L* @opindex -L @@ -914,19 +924,14 @@ If your printer offsets every other page consistently, instead of every page, your best recourse is to use @samp{bop-hook} (@pxref{PostScript hooks}). -@item -p [=]@var{num} -@opindex -p [=]@var{num} +@item -p [=]@var{num}[.@var{pageseq}] +@opindex -p [=]@var{num}[.@var{pageseq}] @cindex first page printed @cindex page, first printed @cindex physical page number, and @samp{-p} @cindex absolute page number, and @samp{-p} -The first page printed will be the first one numbered @var{num}. Default -is the first page in the document. If @var{num} is prefixed by an -equals sign, then it (and the argument to the @samp{-l} option, if -specified) is treated as a physical (absolute) page number, rather than -a value to compare with the @TeX{} @samp{\count0} values stored in the -DVI file. Thus, using @samp{-p =3} will start with the third page of -the document, no matter what the pages are actually numbered. +Exactly analogous to @code{-l} (q.v.), but specifying the first page +number to be printed (processed). @item -pp @var{first}-@var{last} @opindex -pp @var{first}-@var{last} -- cgit v1.2.3