diff options
| -rw-r--r-- | Build/source/texk/dvipsk/config.ps | 1 | ||||
| -rw-r--r-- | Build/source/texk/dvipsk/dvips.info | 496 | ||||
| -rw-r--r-- | Build/source/texk/dvipsk/dvips.texi | 76 |
3 files changed, 338 insertions, 235 deletions
diff --git a/Build/source/texk/dvipsk/config.ps b/Build/source/texk/dvipsk/config.ps index a404e923c42..b1d669a0b7d 100644 --- a/Build/source/texk/dvipsk/config.ps +++ b/Build/source/texk/dvipsk/config.ps @@ -573,6 +573,7 @@ j @+ if @+ %%EndPaperSize +% use -t unknown with a \special{papersize=...} for a nonstandard page size. @ unknown 0in 0in @+ statusdict /setpageparams known { hsize vsize 0 1 statusdict begin { @+ setpageparams } stopped end } { true } ifelse { statusdict /setpage known diff --git a/Build/source/texk/dvipsk/dvips.info b/Build/source/texk/dvipsk/dvips.info index adfde7a1831..3fc72474524 100644 --- a/Build/source/texk/dvipsk/dvips.info +++ b/Build/source/texk/dvipsk/dvips.info @@ -1,6 +1,6 @@ -This is dvips.info, produced by makeinfo version 4.8 from dvips.texi. +This is dvips.info, produced by makeinfo version 4.11 from dvips.texi. - This manual documents Dvips version 5.96 (January 2007), a program +This manual documents Dvips version 5.96dev (December 2007), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. @@ -17,8 +17,8 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir) Dvips ***** -This manual documents Dvips version 5.96 (January 2007), a program to -translate a DVI file into PostScript. You may freely use, modify +This manual documents Dvips version 5.96dev (December 2007), a program +to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. * Menu: @@ -139,18 +139,18 @@ File: dvips.info, Node: config.ps installation, Next: PostScript font installa Dvips has its own configuration files: a file `config.ps' for sitewide defaults, and a file `config.PRINTER' for each printer (output device). -Since these are site-specific, `make install' does not create them; -you must create them yourself. +Since these are site-specific, `make install' does not create them; you +must create them yourself. (These Dvips configuration files are independent of the Kpathsea configuration file `texmf.cnf' (*note Config files: (kpathsea)Config files.). Dvips configuration files contents and searching are described fully -in *Note Config files::. The simplest way to create a new +in *note Config files::. The simplest way to create a new configuration file is to copy and modify the file `dvipsk/contrib/config.proto', seasoning with options to your taste -from *Note Config files::. Here is `config.proto' for your reading +from *note Config files::. Here is `config.proto' for your reading pleasure: % Prototype Dvips configuration file. @@ -314,6 +314,11 @@ yourself in such a situation. For details on effective bug reporting, common installation problems, and `mktexpk' problems, *note Bugs: (kpathsea)Bugs. + A good first debugging operation is to set the environment variable +`DVIPSDEBUG', which will display any configuration and map files read +by Dvips. This way you can be sure it's finding the files and settings +you expect. + * Menu: * Debug options:: Getting diagnostics. @@ -337,6 +342,9 @@ multiple classes, sum the numbers of the classes you wish to track. To track all classes, you can use `-1'. Another useful value is `3650', which tracks everything having to do with file searching and opening. + You can also set the environment variable `KPATHSEA_DEBUG' to any of +these values. + Some of these debugging options are actually provided by Kpathsea (*note Debugging: (kpathsea)Debugging.). @@ -427,7 +435,7 @@ force Dvips to do this with the `-F' flag (or `F' config file option), but this generates files with a terminating binary character (control-D). You can also try using the `-s' flag (or `s' config file option) to enclose the entire job in a save/restore pair. *Note -Command-line options::, and *Note Config files::. +Command-line options::, and *note Config files::. File: dvips.info, Node: Printer errors, Next: Long documents fail, Prev: Small or inverted, Up: Diagnosing problems @@ -560,34 +568,38 @@ Here is a handy summary of the options; it is printed out when you run Dvips with no arguments or with the standard `--help' option. Usage: dvips [OPTION]... FILENAME[.dvi] -a* Conserve memory, not time A Print only odd (TeX) pages -b # Page copies, for posters e.g. B Print only even (TeX) pages -c # Uncollated copies C # Collated copies -d # Debugging D # Resolution -e # Maxdrift value E* Try to create EPSF -f* Run as filter F* Send control-D at end - G* Shift low chars to higher pos. -h f Add header file -i* Separate file per section -j* Download fonts partially -k* Print crop marks K* Pull comments from inclusions -l # Last page -m* Manual feed M* Don't make fonts -mode s Metafont device name -n # Maximum number of pages N* No structured comments -noomega Disable Omega extensions -o f Output file O c Set/change paper offset -p # First page P s Load config.$s -pp l Print only pages listed -q* Run quietly -r* Reverse order of pages R* Run securely -s* Enclose output in save/restore S # Max section size in pages -t s Paper format T c Specify desired page size -u s PS mapfile U* Disable string param trick -v Print version number and quit V* Send downloadable PS fonts as PK -x # Override dvi magnification X # Horizontal resolution -y # Multiply by dvi magnification Y # Vertical resolution -z* Hyper PS Z* Compress bitmap fonts +Convert DVI input files to PostScript. +See http://tug.org/dvips/ for the full manual and other information. + +Options: +-a* Conserve memory, not time -A Print only odd (TeX) pages +-b # Page copies, for posters e.g. -B Print only even (TeX) pages +-c # Uncollated copies -C # Collated copies +-d # Debugging -D # Resolution +-e # Maxdrift value -E* Try to create EPSF +-f* Run as filter -F* Send control-D at end + -G* Shift low chars to higher pos. +-h f Add header file +-i* Separate file per section +-j* Download fonts partially +-k* Print crop marks -K* Pull comments from inclusions +-l # Last page +-m* Manual feed -M* Don't make fonts +-mode s Metafont device name +-n # Maximum number of pages -N* No structured comments +-noomega Disable Omega extensions +-o f Output file -O c Set/change paper offset +-p # First page -P s Load config.$s +-pp l Print only pages listed +-q* Run quietly +-r* Reverse order of pages -R* Run securely +-s* Enclose output in save/restore -S # Max section size in pages +-t s Paper format -T c Specify desired page size +-u s PS mapfile -U* Disable string param trick +-v Print version number and quit -V* Send downloadable PS fonts as PK +-x # Override dvi magnification -X # Horizontal resolution +-y # Multiply by dvi magnification -Y # Vertical resolution +-z* Hyper PS -Z* Compress bitmap fonts # = number f = file s = string * = suffix, `0' to turn off c = comma-separated dimension pair (e.g., 3.2in,-32.1cm) l = comma-separated list of page ranges (e.g., 1-4,7-9) @@ -724,8 +736,8 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. document processed independently, most often created to avoid memory overflow. The filenames are created replacing the suffix of the supplied output file name by a three-digit sequence number. - This option is most often used in conjunction with the `-S' - option which sets the maximum section length in pages; if `-i' is + This option is most often used in conjunction with the `-S' option + which sets the maximum section length in pages; if `-i' is specified and `-S' is not, each page is output as a separate file. For instance, some phototypesetters cannot print more than ten or so consecutive pages before running out of steam; these options @@ -773,7 +785,7 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. With the default paths, explicitly specifying the mode also makes the program assume the fonts are in a subdirectory named MODE. *Note TeX directory structure: (kpathsea)TeX directory structure. - If Metafont does not understand the MODE name, see *Note Unable to + If Metafont does not understand the MODE name, see *note Unable to generate fonts: (kpathsea)Unable to generate fonts. `-M*' @@ -909,13 +921,21 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. `-t PAPERTYPE' Set the paper type to PAPERTYPE, usually defined in one of the configuration files, along with the appropriate PostScript code to - select it (*note Config file paper sizes::). You can also specify - a PAPERTYPE of `landscape', which rotates a document by 90 - degrees. To rotate a document whose paper type is not the - default, you can use the `-t' option twice, once for the paper - type, and once for `landscape'. You should not use any `-t' - option when TeX writes a `papersize' special, as is done by some - LaTeX packages, e.g., `hyperref.sty'. + select it (*note Config file paper sizes::). + - You can also specify a PAPERTYPE of `landscape', which + rotates a document by 90 degrees. + + - To rotate a document whose paper type is not the default, you + can use the `-t' option twice, once for the paper type, and + once for `landscape'. + + - In general, you should not use any `-t' option when using a + `papersize' special, as some LaTeX packages do, e.g., + `hyperref.sty'. + + - The exception is when using a nonstandard paper size that is + not already defined in `config.ps'; in this case, you need to + specify `-t unknown'. `-T HSIZE,VSIZE' Set the paper size to (HSIZE,VSIZE), a comma-separated pair of @@ -1002,6 +1022,15 @@ details of interpretation of path and other environment variables common to all Kpathsea-using programs. Only the environment variables specific to Dvips are mentioned here. +`DVIPSDEBUG' + Write the absolute path names of any configuration or map files to + standard output, for debugging. This isn't done by default because + these files are read even before the banner is printed. For + voluminous additional debugging, set the environment variable + `KPATHSEA_DEBUG' to `-1' (*note Debugging: (kpathsea)Debugging.). + (If `KPATHSEA_DEBUG' is set to any value, it automatically turns + on `DVIPSDEBUG'.) + `DVIPSFONTS' Default path to search for all fonts. Overrides all the font path config file options and other environment variables (*note @@ -1076,7 +1105,7 @@ or individually by each user. 1. Dvips first reads (if it exists) `config.ps'; it is searched for along the path for Dvips configuration files, as described in - *Note Supported file formats: (kpathsea)Supported file formats. + *note Supported file formats: (kpathsea)Supported file formats. 2. A user-specific startup file is loaded, so individual users can override any options set in the global file. The environment @@ -1087,7 +1116,7 @@ or individually by each user. the user's home directory. On MS-DOS and MS-Windows, where users generally don't have their private directories, the startup file is called `dvips.ini' and it is searched for along the path for - Dvips configuration files (as described in *Note Supported file + Dvips configuration files (as described in *note Supported file formats: (kpathsea)Supported file formats.); users are expected to set this path as they see fit for their taste. @@ -1330,7 +1359,7 @@ File: dvips.info, Node: Paper size and landscape, Next: Interaction with PostS 4 Paper size and landscape orientation ************************************** -Most TeX documents at a particular site are designed to use the +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. @@ -1343,11 +1372,11 @@ is called "landscape" orientation (the default orientation is "portrait"). Alternatively, a document might be designed for ledger or A3 paper. - Since the intended paper size is a document design decision, not a -printing decision, such information should be given in the TeX file and -not on the Dvips command line. For this reason, Dvips supports a -`papersize' special. It is hoped that this special will become -standard over time for TeX previewers and other printer drivers. + Since the intended paper size in these cases is a document design +decision, not a printing decision, such information should be given in +the TeX file and not on the Dvips command line. For this reason, Dvips +supports a `papersize' special. It is hoped that this special will +become standard over time for TeX previewers and other printer drivers. Some LaTeX packages, e.g., `hyperref.sty', write a `papersize' special into the DVI file. In this case, you need not and should not @@ -1388,8 +1417,13 @@ reventually the `papersize' comment will dominate. size; you must also adjust `\hsize' and `\vsize' in your TeX document typeset to those dimensions. + When using the `papersize' special, you generally should not also +specify `-t' on the command line (*note Option details::). The +exception is when using a nonstandard paper size that isn't predefined; +in this case, use `-t unknown'. + The `papersize' special must occur somewhere on the first page of -the document. +the document. Some packages, notably `hyperref', insert this special. File: dvips.info, Node: Config file paper sizes, Next: Paper trays, Prev: papersize special, Up: Paper size and landscape @@ -1460,27 +1494,26 @@ as the NeXT) want `PaperSize' comments and they will handle setting the paper size. There is no solution I could find that works for both (except maybe specifying both). - The Perl 5 script `contrib/mkdvipspapers' in the distribution -directory may help in determining appropriate paper size definitions. - - If your printers are configured to use A4 paper by default, the -configuration file (probably the global `config.ps' in this case) -should include this as the first `@' command: + When using a paper size that is not already defined in `config.ps', +you probably want to say `-t unknown' on the command line; the +`unknown' paper size definition in `config.ps' has the requisite +PostScript incantation to set the PostScript page size, as just +described. - @ A4size 210mm 297mm - @+ %%PaperSize: A4 + The Perl 5 script `contrib/configs/mkdvipspapers' in the +distribution directory may help in determining appropriate paper size +definitions. -so that `A4size' is used as the default, and not `A4' itself; thus, no -PostScript `a4' command is added to the output file, unless the user -explicitly says to use paper size `a4'. That is, by default, no paper -size PostScript command should be put in the output, but Dvips will -still know that the paper size is A4 because `A4size' is the first (and -therefore default) size in the configuration file. + Notwithstanding the above, the default `letter' and `a4' paper size +definitions in `config.ps' execute the `setpagedevice' operator if it +exists (it was defined in PostScript Level 2), or the `letter' or `a4' +operator if they exist (they are nonstandard and thus perhaps cause +failures on certain (unknown) printers). Not executing any page size +definition at all confuses PostScript conversion programs such as +`ps2pdf', so we want to execute one if we can. - Executing the `letter' or `a4' or other PostScript operators cause -the document to be nonconforming and can cause it not to print on -certain printers, so the default paper size should not execute such an -operator if at all possible. + The `letterSize' and `A4Size' paper size definitions are now +synonyms for `letter' and `a4'. File: dvips.info, Node: Paper trays, Prev: Config file paper sizes, Up: Paper size and landscape @@ -1854,32 +1887,44 @@ the PostScript. The possible KEYs are: `hoffset' - The horizontal offset (default 0) + The horizontal offset (default 0). `voffset' - The vertical offset (default 0) + The vertical offset (default 0). `hsize' - The horizontal clipping size (default 612) + The horizontal clipping size (default 612). `vsize' - The vertical clipping size (default 792) + The vertical clipping size (default 792). `hscale' - The horizontal scaling factor (default 100) + The horizontal scaling factor, as a percentage (default 100). `vscale' - The vertical scaling factor (default 100) + The vertical scaling factor, as a percentage (default 100). `angle' - The rotation (default 0) + The rotation, in degrees (default 0). `clip' - Enable clipping to the bounding box + Enable clipping to the bounding box (default disabled). - The dimension parameters are all given in PostScript units. The -`hscale' and `vscale' are given in non-dimensioned percentage units, -and the rotation value is specified in degrees. Thus +`llx, lly, urx, ury' + Bounding box of the included image, just as in a `%%BoundingBox' + comment. Values are in big points, and may be fractional. + +`rhi, rwi' + Desired width and height of the resulting figure in the output, in + tenths of big points (720 to the inch); may be fractional. + + If both `rwi' and `rhi' are nonzero, the picture is scaled, + possibly losing aspect ratio. If only one of `rwi' and `rhi' is + nonzero, the picture is scaled, preserving aspect ratio. + + + The offsets and sizes are given in PostScript units (big points). +Thus, for example: \special{psfile=foo.ps hoffset=72 hscale=90 vscale=90} @@ -2078,7 +2123,7 @@ File: dvips.info, Node: Headers and memory usage, Prev: Including headers from ------------------------------ Dvips tries to avoid overflowing the printer's memory by splitting the -output files into "sections" (see the `-i' option in *Note Option +output files into "sections" (see the `-i' option in *note Option details::). Therefore, for all header files, Dvips debits the printer VM budget by some value. If the header file has, in its leading commentary a line of the form @@ -2149,12 +2194,17 @@ of the following will work: \special{ps::TEXT} \special{ps::[begin]TEXT} \special{ps::[end]TEXT} + \special{ps::[nobreak]TEXT} (with longer forms taking precedence over shorter forms, when they are present). `ps::' and `ps::[end]' do no positioning, so they can be used to continue PostScript literals started with `ps:' or `ps::[begin]'. + Literal PostScript instructions after `ps::[nobreak]' are _not_ +broken into lines. This feature may be used to include PostScript +comments, for example. + In addition, the variant \special{ps: plotfile FILENAME} @@ -2623,7 +2673,7 @@ virtual font, a recipe for typesetting that character. A VF file, like a TFM file, is in a compressed binary format. The `vftovp' and `vptovf' programs convert a VF file to a human-readable VPL (virtual property list) format and back again. *Note vftovp invocation: -(web2c)vftovp invocation, and *Note vptovf invocation: (web2c)vptovf +(web2c)vftovp invocation, and *note vptovf invocation: (web2c)vptovf invocation. In the case of a PostScript font F being used in a straightforward @@ -2895,7 +2945,7 @@ File: dvips.info, Node: Changing font encodings, Next: Special font effects, Afm2tfm allows you to specify a different encoding for a PostScript font (for a general introduction to encodings, *note Encodings::). The `-t' -options changes the TeX encoding, `-p' changes the PostScript encoding, +option changes the TeX encoding, `-p' changes the PostScript encoding, and `-T' changes both simultaneously, as detailed in the sections below. * Menu: @@ -3777,25 +3827,25 @@ Index * -s SLANT: Afm2tfm options. (line 51) * -T ENC-FILE: Changing both encodings. (line 6) -* -T HSIZE,VSIZE: Option details. (line 324) +* -T HSIZE,VSIZE: Option details. (line 332) * -t PAPERTYPE: Option details. (line 313) * -T PS-TEX-ENC: Afm2tfm options. (line 61) * -t TEX-ENC <1>: Afm2tfm options. (line 56) * -t TEX-ENC: Changing TeX encodings. (line 6) * -u: Afm2tfm options. (line 65) -* -U: Option details. (line 339) -* -u PSMAPFILE: Option details. (line 331) -* -V: Option details. (line 350) -* -v: Option details. (line 347) +* -U: Option details. (line 347) +* -u PSMAPFILE: Option details. (line 339) +* -V: Option details. (line 358) +* -v: Option details. (line 355) * -V VPL-FILE: Afm2tfm options. (line 74) * -v VPL-FILE: Afm2tfm options. (line 71) -* -X NUM: Option details. (line 367) -* -x NUM: Option details. (line 359) -* -Y NUM: Option details. (line 374) +* -X NUM: Option details. (line 375) +* -x NUM: Option details. (line 367) +* -Y NUM: Option details. (line 382) * -z: Hypertext. (line 6) -* -Z for compressing bitmap fonts: Option details. (line 383) -* -z for recognizing hyperdvi: Option details. (line 377) +* -Z for compressing bitmap fonts: Option details. (line 391) +* -z for recognizing hyperdvi: Option details. (line 385) * .afm Adobe metric files: Metric files. (line 26) * .dvipsrc, searched for: Configuration file searching. (line 14) @@ -3851,9 +3901,11 @@ Index * A ring, Scandinavian letter: Reencoding with Afm2tfm. (line 32) * a3 papertype: Option details. (line 313) -* a4 paper size, as default: Config file paper sizes. - (line 72) +* a4 paper size: Config file paper sizes. + (line 79) * a4 papertype: Option details. (line 313) +* A4size paper size: Config file paper sizes. + (line 87) * absolute filenames, disabling: Option details. (line 293) * absolute page number, and -l: Option details. (line 162) * absolute page number, and -p: Option details. (line 253) @@ -3875,6 +3927,7 @@ Index * Aladdin Ghostscript: Ghostscript installation. (line 6) * Anderson, Laurie: Hypertext specials. (line 42) +* angle (psfile special option): psfile special. (line 36) * arcs: Glyph files. (line 17) * ASCII character codes, used by PostScript: PostScript typesetting. (line 31) @@ -3898,7 +3951,8 @@ Index (line 19) * bop undefined error: Printer errors. (line 6) * bop-hook <1>: PostScript hooks. (line 11) -* bop-hook: EPSF scaling. (line 75) +* bop-hook <2>: EPSF scaling. (line 75) +* bop-hook: Paper trays. (line 6) * bop-hook, and offset pages: Option details. (line 248) * boundary character: Encoding file format. (line 41) @@ -3919,6 +3973,7 @@ Index (line 6) * CharStrings Type 1 dictionary: PostScript typesetting. (line 51) +* clip (psfile special option): psfile special. (line 39) * clipping of EPSF: EPSF clipping. (line 6) * CODINGSCHEME: Reencoding with Afm2tfm. (line 52) @@ -3946,7 +4001,7 @@ Index * compilation: Installation. (line 6) * compressed PostScript: Dynamic creation of graphics. (line 6) -* compressing bitmap fonts: Option details. (line 383) +* compressing bitmap fonts: Option details. (line 391) * Computer Modern in PostScript: Hypertext caveats. (line 6) * Computer Modern, encoding of: Encodings. (line 15) * condensed fonts: Afm2tfm options. (line 37) @@ -3955,6 +4010,8 @@ Index * config.ps: Option details. (line 267) * config.ps installation: config.ps installation. (line 6) +* config.ps paper sizes: Config file paper sizes. + (line 79) * config.ps, searched for: Configuration file searching. (line 10) * configuration file options: Configuration file commands. @@ -3962,7 +4019,7 @@ Index * configuration file paper size command: Config file paper sizes. (line 6) * configuration file path: Environment variables. - (line 47) + (line 56) * configuration file searching: Configuration file searching. (line 6) * configuration files: Config files. (line 6) @@ -4006,7 +4063,7 @@ Index (line 35) * dictionary, SDict: Literal headers. (line 6) * dictionary, userdict: Header files. (line 21) -* distillation, and -z: Option details. (line 377) +* distillation, and -z: Option details. (line 385) * distiller, for PDF files: Hypertext. (line 11) * dot accent: Reencoding with Afm2tfm. (line 32) @@ -4023,18 +4080,20 @@ Index * Dvips configuration file options: Configuration file commands. (line 6) * dvips.enc: Encodings. (line 35) -* DVIPSFONTS: Environment variables. +* DVIPSDEBUG: Environment variables. (line 17) +* DVIPSFONTS: Environment variables. + (line 26) * DVIPSHEADERS: Environment variables. - (line 22) + (line 31) * DVIPSHEADERS, overrides H: Configuration file commands. (line 47) * DVIPSMAKEPK: Environment variables. - (line 26) + (line 35) * DVIPSRC: Environment variables. - (line 32) + (line 41) * DVIPSSIZES: Environment variables. - (line 37) + (line 46) * DVIPSSIZES, overrides R: Configuration file commands. (line 136) * dynamic creation of graphics: Dynamic creation of graphics. @@ -4143,7 +4202,7 @@ Index * gs installation: Ghostscript installation. (line 6) * gsave/grestore, and literal PS: Literal examples. (line 27) -* gsftopk: Option details. (line 351) +* gsftopk: Option details. (line 359) * h header downloading config command: Configuration file commands. (line 44) * H header path config command: Configuration file commands. @@ -4163,17 +4222,20 @@ Index (line 6) * hints: PostScript typesetting. (line 55) +* hoffset (psfile special option): psfile special. (line 18) * HP printers and Type 1 fonts: PostScript font installation. (line 69) * HP4Si printer and paper trays: Paper trays. (line 6) * href: Hypertext specials. (line 32) +* 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 377) +* html specials, and -z: Option details. (line 385) * 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 377) +* hyperdvi extensions, enabling: Option details. (line 385) * hypertext and bitmap fonts: Hypertext caveats. (line 6) * hypertext caveats: Hypertext caveats. (line 6) * hypertext specials: Hypertext specials. (line 6) @@ -4208,19 +4270,25 @@ Index * K config command (comment-removeal): Configuration file commands. (line 59) * kerning, defined: Metric files. (line 15) +* KPATHSEA_DEBUG: Environment variables. + (line 18) * landscape orientation, defined: Paper size and landscape. (line 11) * landscape papertype: Option details. (line 313) * landscape, as \special: papersize special. (line 16) * last page printed: Option details. (line 162) * last-resort font scaling, with DVIPSSIZES: Environment variables. - (line 38) + (line 47) * last-resort scaling, with R: Configuration file commands. (line 123) * ledger papertype: Option details. (line 313) * legal papertype: Option details. (line 313) +* letter paper size: Config file paper sizes. + (line 79) * letter papertype: Option details. (line 313) * letterhead tray: Paper trays. (line 10) +* letterSize paper size: Config file paper sizes. + (line 87) * ligature operations: Encoding file format. (line 54) * ligature, defined: Metric files. (line 15) @@ -4231,6 +4299,8 @@ Index * literal headers: Literal headers. (line 6) * literal PostScript, examples: Literal examples. (line 6) * literal PostScript, using: Literal PS. (line 6) +* llx (psfile special option): psfile special. (line 42) +* 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 223) @@ -4244,8 +4314,8 @@ Index * macros for epsf inclusion <1>: EPSF macros. (line 6) * macros for epsf inclusion: \includegraphics. (line 6) * magnification, DVI: EPSF scaling. (line 63) -* magnification, overriding DVI: Option details. (line 359) -* magnification, vertical: Option details. (line 370) +* magnification, overriding DVI: Option details. (line 367) +* magnification, vertical: Option details. (line 378) * mailcap and hypertext: Hypertext specials. (line 53) * manual feed: Option details. (line 171) * maxdrift: Option details. (line 71) @@ -4269,16 +4339,16 @@ Index * MISSFONT_LOG: Option details. (line 186) * Mitsubishi Shinko CHC-S446i printer: No output. (line 14) * mkdvipspapers: Config file paper sizes. - (line 69) + (line 75) * mktexpk, avoiding: Option details. (line 183) * mktexpk, changing name: Environment variables. - (line 27) + (line 36) * mode name, specifying: Option details. (line 174) * Monotype fonts: PostScript font installation. (line 10) * Monotype fonts, installing: PostScript font installation. (line 19) -* mtpk: Option details. (line 351) +* mtpk: Option details. (line 359) * multiple master fonts: psfonts.map. (line 27) * multiple output files: Option details. (line 126) * multiple paper trays: Paper trays. (line 6) @@ -4344,7 +4414,7 @@ Index * PDF files, making <1>: Hypertext. (line 11) * PDF files, making: Ghostscript installation. (line 6) -* PDF files, option for: Option details. (line 377) +* PDF files, option for: Option details. (line 385) * pdfmark: Hypertext. (line 6) * pfa files: Glyph files. (line 25) * pfb files: Glyph files. (line 25) @@ -4359,9 +4429,11 @@ Index * pk files: Glyph files. (line 35) * PKFONTS, overrides P: Configuration file commands. (line 110) -* plotfile, ps subspecial: ps special. (line 25) +* plotfile, ps subspecial: ps special. (line 30) * pltotf: Metric files. (line 39) * popen for output: Option details. (line 223) +* portrait orientation, defined: Paper size and landscape. + (line 11) * positioning accuracy: Option details. (line 71) * post code after headers: Including headers from TeX. (line 28) @@ -4371,7 +4443,7 @@ Index (line 6) * PostScript font alias file <1>: Configuration file commands. (line 101) -* PostScript font alias file: Option details. (line 331) +* PostScript font alias file: Option details. (line 339) * PostScript fonts: PostScript fonts. (line 6) * PostScript fonts, installing: PostScript font installation. (line 6) @@ -4390,7 +4462,7 @@ Index * previewing Dvips output: Ghostscript installation. (line 6) * PRINTER: Environment variables. - (line 41) + (line 50) * printer configuration: config.ps installation. (line 6) * printer configuration file, prototype: config.ps installation. @@ -4417,7 +4489,7 @@ Index (line 24) * psheaderdir: Header files. (line 12) * psi character missing: Hypertext caveats. (line 55) -* pstopk: Option details. (line 351) +* pstopk: Option details. (line 359) * Q config command (quiet): Configuration file commands. (line 117) * q config command (quiet): Configuration file commands. @@ -4438,12 +4510,14 @@ Index * resident fonts, different in different printers <1>: Configuration file commands. (line 101) * resident fonts, different in different printers: Option details. - (line 331) -* resolution: Option details. (line 367) + (line 339) +* resolution: Option details. (line 375) * resolution, setting: Option details. (line 58) * reverse pagination: Option details. (line 290) +* rhi (psfile special option): psfile special. (line 46) * Rokicki, Tomas: Why Dvips. (line 68) -* rotate.tex: ps special. (line 29) +* rotate.tex: ps special. (line 34) +* rwi (psfile special option): psfile special. (line 46) * S config command (pict path): Configuration file commands. (line 148) * s config command (save/restore): Configuration file commands. @@ -4452,14 +4526,14 @@ Index * save/restore, and literal PS: Literal examples. (line 27) * save/restore, and specials: ps special. (line 6) * save/restore, generating global: Option details. (line 301) -* scaleunit: psfile special. (line 55) +* scaleunit: psfile special. (line 67) * scaling of figures: EPSF scaling. (line 6) * scaling small caps: Afm2tfm options. (line 33) * Scandinavian A ring: Reencoding with Afm2tfm. (line 32) * screen frequencies, setting: Including headers from the command line. (line 13) -* SDict: psfile special. (line 55) +* SDict: psfile special. (line 67) * SDict dictionary: Literal headers. (line 6) * searching config files, order of: Configuration file searching. (line 6) @@ -4512,7 +4586,7 @@ Index * TeX, including headers in: Including headers from TeX. (line 6) * TEXCONFIG: Environment variables. - (line 46) + (line 55) * TEXFONTS, overrides P: Configuration file commands. (line 110) * TEXFONTS, overrides T: Configuration file commands. @@ -4526,7 +4600,7 @@ Index (line 16) * texmsym.enc: Encodings. (line 35) * TEXPICTS: Environment variables. - (line 53) + (line 62) * TEXPICTS, overrides S: Configuration file commands. (line 148) * TEXPKS, overrides P: Configuration file commands. @@ -4557,8 +4631,11 @@ Index * uncompressing PostScript: Dynamic creation of graphics. (line 6) * uniform resource locator: Hypertext specials. (line 20) +* unknown, paper format for -t: papersize special. (line 29) * URL, definition: Hypertext specials. (line 27) * URL, extended for TeX: Hypertext specials. (line 20) +* urx (psfile special option): psfile special. (line 42) +* ury (psfile special option): psfile special. (line 42) * user-definable colors: User-definable colors. (line 6) * userdict, and dictionary files: Header files. (line 21) @@ -4575,9 +4652,12 @@ Index * VM exhausted: Printer errors. (line 14) * VMusage: Headers and memory usage. (line 12) +* voffset (psfile special option): psfile special. (line 21) * vpl files: Virtual fonts. (line 16) * vptovf: Making a font available. (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 167) * warning messages, defining: Configuration file commands. @@ -4587,7 +4667,7 @@ Index * wide fonts: psfonts.map. (line 32) * X config command (horizontal resolution): Configuration file commands. (line 174) -* Xerox 4045: Option details. (line 339) +* Xerox 4045: Option details. (line 347) * Y config command (vertical resolution): Configuration file commands. (line 177) * Y&Y fonts, installing: PostScript font installation. @@ -4601,82 +4681,82 @@ Index Tag Table: -Node: Top522 -Node: Why Dvips1269 -Node: Installation4717 -Node: config.ps installation5855 -Node: PostScript font installation8397 -Node: Ghostscript installation11271 -Node: Diagnosing problems12368 -Node: Debug options13237 -Node: No output14353 -Node: Small or inverted15821 -Node: Printer errors16540 -Node: Long documents fail17872 -Node: Including graphics fails18213 -Node: Invoking Dvips19451 -Node: Basic usage20042 -Node: Command-line options21026 -Node: Option summary21475 -Node: Option details23451 -Node: Environment variables41842 -Node: Config files44345 -Node: Configuration file searching45028 -Node: Configuration file commands48328 -Node: Paper size and landscape55345 -Node: papersize special56922 -Node: Config file paper sizes58036 -Node: Paper trays62135 -Node: Interaction with PostScript63469 -Node: PostScript figures64122 -Node: Bounding box64848 -Node: \includegraphics68219 -Node: EPSF macros70510 -Node: EPSF scaling72480 -Node: EPSF clipping75050 -Node: psfile special75692 -Node: Dynamic creation of graphics77612 -Node: Fonts in figures78930 -Node: Header files80590 -Node: Including headers from TeX81796 -Node: Including headers from the command line83830 -Node: Headers and memory usage84930 -Node: Literal PS85640 -Node: " special86222 -Node: ps special86963 -Node: Literal headers88271 -Node: PostScript hooks88986 -Node: Literal examples91076 -Node: Hypertext92528 -Node: Hypertext caveats94086 -Node: Hypertext specials98483 -Node: PostScript fonts101117 -Node: Font concepts102233 -Node: Metric files103400 -Node: Glyph files106226 -Node: Virtual fonts108582 -Node: Encodings110472 -Node: PostScript typesetting112854 -Node: Making a font available115936 -Node: Invoking afm2tfm120966 -Node: Changing font encodings121936 -Node: Changing TeX encodings122727 -Node: Changing PostScript encodings123827 -Node: Changing both encodings125171 -Node: Reencoding with Afm2tfm125844 -Node: Encoding file format128948 -Node: Special font effects133151 -Node: Afm2tfm options135414 -Node: psfonts.map138399 -Node: Color143123 -Node: Color macro files144167 -Node: User-definable colors147365 -Node: Color subtleties148640 -Node: Ted Turner150291 -Node: Color device configuration151516 -Node: Color support details153958 -Node: Color specifications154336 -Node: Color specials155739 -Node: Index157868 +Node: Top524 +Node: Why Dvips1275 +Node: Installation4723 +Node: config.ps installation5861 +Node: PostScript font installation8403 +Node: Ghostscript installation11277 +Node: Diagnosing problems12374 +Node: Debug options13469 +Node: No output14672 +Node: Small or inverted16140 +Node: Printer errors16859 +Node: Long documents fail18191 +Node: Including graphics fails18532 +Node: Invoking Dvips19770 +Node: Basic usage20361 +Node: Command-line options21345 +Node: Option summary21794 +Node: Option details23956 +Node: Environment variables42571 +Node: Config files45530 +Node: Configuration file searching46213 +Node: Configuration file commands49513 +Node: Paper size and landscape56530 +Node: papersize special58128 +Node: Config file paper sizes59537 +Node: Paper trays63609 +Node: Interaction with PostScript64943 +Node: PostScript figures65596 +Node: Bounding box66322 +Node: \includegraphics69693 +Node: EPSF macros71984 +Node: EPSF scaling73954 +Node: EPSF clipping76524 +Node: psfile special77166 +Node: Dynamic creation of graphics79559 +Node: Fonts in figures80877 +Node: Header files82537 +Node: Including headers from TeX83743 +Node: Including headers from the command line85777 +Node: Headers and memory usage86877 +Node: Literal PS87587 +Node: " special88169 +Node: ps special88910 +Node: Literal headers90408 +Node: PostScript hooks91123 +Node: Literal examples93213 +Node: Hypertext94665 +Node: Hypertext caveats96223 +Node: Hypertext specials100620 +Node: PostScript fonts103254 +Node: Font concepts104370 +Node: Metric files105537 +Node: Glyph files108363 +Node: Virtual fonts110719 +Node: Encodings112609 +Node: PostScript typesetting114991 +Node: Making a font available118073 +Node: Invoking afm2tfm123103 +Node: Changing font encodings124073 +Node: Changing TeX encodings124863 +Node: Changing PostScript encodings125963 +Node: Changing both encodings127307 +Node: Reencoding with Afm2tfm127980 +Node: Encoding file format131084 +Node: Special font effects135287 +Node: Afm2tfm options137550 +Node: psfonts.map140535 +Node: Color145259 +Node: Color macro files146303 +Node: User-definable colors149501 +Node: Color subtleties150776 +Node: Ted Turner152427 +Node: Color device configuration153652 +Node: Color support details156094 +Node: Color specifications156472 +Node: Color specials157875 +Node: Index160004 End Tag Table diff --git a/Build/source/texk/dvipsk/dvips.texi b/Build/source/texk/dvipsk/dvips.texi index 486ba6a0814..f7dd1b0d025 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.96dev -@set month-year September 2007 +@set month-year December 2007 @copying This manual documents Dvips version @value{version} @@ -1077,13 +1077,20 @@ more information. @cindex papersize special, and no @samp{-t} Set the paper type to @var{papertype}, usually defined in one of the configuration files, along with the appropriate PostScript code to -select it (@pxref{Config file paper sizes}). You can also specify a -@var{papertype} of @samp{landscape}, which rotates a document by 90 -degrees. To rotate a document whose paper type is not the default, you +select it (@pxref{Config file paper sizes}). +@itemize @minus{} +@item You can also specify a @var{papertype} of @samp{landscape}, +which rotates a document by 90 degrees. +@item To rotate a document whose paper type is not the default, you can use the @samp{-t} option twice, once for the paper type, and once -for @samp{landscape}. You should not use any @samp{-t} option when -@TeX{} writes a @samp{papersize} special, as is done by some @LaTeX{} -packages, e.g., @samp{hyperref.sty}. +for @samp{landscape}. +@item In general, you should not use any @samp{-t} option when +using a @samp{papersize} special, as some @LaTeX{} packages do, e.g., +@samp{hyperref.sty}. +@item The exception is when using a nonstandard paper size that is not +already defined in @file{config.ps}; in this case, you need to specify +@samp{-t@tie{}unknown}. +@end itemize @item -T @var{hsize},@var{vsize} @opindex -T @var{hsize},@var{vsize} @@ -1623,11 +1630,12 @@ on the command line, that takes precedence. @cindex paper size, general Most @TeX{} documents at a particular site are designed to use the -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 in +Europe). 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, @@ -1636,11 +1644,12 @@ is called @dfn{landscape} orientation (the default orientation is @dfn{portrait}). Alternatively, a document might be designed for ledger or A3 paper. -Since the intended paper size is a document design decision, not a -printing decision, such information should be given in the @TeX{} file -and not on the Dvips command line. For this reason, Dvips supports a -@samp{papersize} special. It is hoped that this special will become -standard over time for @TeX{} previewers and other printer drivers. +Since the intended paper size in these cases is a document design +decision, not a printing decision, such information should be given in +the @TeX{} file and not on the Dvips command line. For this reason, +Dvips supports a @samp{papersize} special. It is hoped that this +special will become standard over time for @TeX{} previewers and other +printer drivers. Some @LaTeX{} packages, e.g., @samp{hyperref.sty}, write a @samp{papersize} special into the DVI file. In this case, you need @@ -1691,8 +1700,14 @@ 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 +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 document. +the document. Some packages, notably @samp{hyperref}, insert this special. @node Config file paper sizes @@ -1773,21 +1788,28 @@ comment or two would be okay). Also, some printers want setting the paper size. There is no solution I could find that works for both (except maybe specifying both). +When using a paper size that is not already defined in +@file{config.ps}, you probably want to say @samp{-t@tie{}unknown} on +the command line; the @code{unknown} paper size definition in +@file{config.ps} has the requisite PostScript incantation to set the +PostScript page size, as just described. + @flindex mkdvipspapers -The Perl 5 script @file{contrib/mkdvipspapers} in the distribution -directory may help in determining appropriate paper size definitions. +The Perl 5 script @file{contrib/configs/mkdvipspapers} in the +distribution directory may help in determining appropriate paper size +definitions. @flindex config.ps @r{paper sizes} @findex letter @r{paper size} @findex a4 @r{paper size} -The default @code{letter} and @code{a4} paper size definitions in -@file{config.ps} execute the @code{setpagedevice} operator if it -exists (it was defined in PostScript Level 2), or the @samp{letter} or -@samp{a4} operator if they exist (they are nonstandard and thus -perhaps cause failures on certain (unknown) printers). Not -executing any page size definition at all confuses PostScript -conversion programs such as @command{ps2pdf}, so we want to execute -one if we can. +Notwithstanding the above, the default @code{letter} and @code{a4} +paper size definitions in @file{config.ps} execute the +@code{setpagedevice} operator if it exists (it was defined in +PostScript Level 2), or the @samp{letter} or @samp{a4} operator if +they exist (they are nonstandard and thus perhaps cause failures on +certain (unknown) printers). Not executing any page size definition +at all confuses PostScript conversion programs such as +@command{ps2pdf}, so we want to execute one if we can. @findex letterSize @r{paper size} @findex A4size @r{paper size} @@ -3641,7 +3663,7 @@ An alternative to Afm2tfm for creating virtual fonts is Alan Jeffrey's Afm2tfm allows you to specify a different encoding for a PostScript font (for a general introduction to encodings, @pxref{Encodings}). The -@samp{-t} options changes the @TeX{} encoding, @samp{-p} changes the +@samp{-t} option changes the @TeX{} encoding, @samp{-p} changes the PostScript encoding, and @samp{-T} changes both simultaneously, as detailed in the sections below. |