From 4e7b82c1404873f4f33e88f28265132a09b95ae7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 3 May 2017 17:42:44 +0000 Subject: TL2017 texinfo updates git-svn-id: svn://tug.org/texlive/trunk@44167 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/dvips/dvips.html | 156 ++++++++++++++++++--------------- Master/texmf-dist/doc/dvips/dvips.pdf | Bin 404161 -> 405131 bytes 2 files changed, 84 insertions(+), 72 deletions(-) (limited to 'Master/texmf-dist/doc/dvips') diff --git a/Master/texmf-dist/doc/dvips/dvips.html b/Master/texmf-dist/doc/dvips/dvips.html index 9ee7e75896a..ecf1a1a7df5 100644 --- a/Master/texmf-dist/doc/dvips/dvips.html +++ b/Master/texmf-dist/doc/dvips/dvips.html @@ -1,9 +1,9 @@ - - + Dvips: A DVI-to-PostScript translator @@ -57,7 +57,6 @@ ul.no-bullet {list-style: none} -

Short Table of Contents

@@ -204,8 +203,8 @@ Next: , Up:

Dvips

-

This manual documents Dvips version 5.996 -(April 2016), a program to translate a DVI file into +

This manual documents Dvips version 5.997 +(April 2017), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file.

@@ -296,7 +295,6 @@ So if you don’t use Dvips on your system, get it today.

Tom Rokicki wrote and maintains the original Dvips program.

-
@@ -881,7 +879,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 @@ -1174,6 +1172,13 @@ Thus, using ‘-l =9’ will end with the ninth page of the 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. See papersize’ special. +

+
-m*
@@ -1295,7 +1300,7 @@ See the ‘-f’ option for how to override this.

Move the origin by x-offset,y-offset, a comma-separated -pair of dimensions such as ‘.1in,-.3cm’ (see papersize special). The origin of the page is shifted from the default position +pair of dimensions such as ‘.1in,-.3cm’ (see 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 printer-specific configuration file. @@ -1365,8 +1370,8 @@ See Configuration file searching. -

Run quietly. Don’t chatter about pages converted, etc. to standard -output; report no warnings (only errors) to standard error. +

Run quietly. Don’t chatter about pages converted, etc., +and report no warnings (only errors) to standard error.

-r*
@@ -1440,7 +1445,7 @@ you can use ‘-E’ to get pure EPSF output.)
-T hsize,vsize

Set the paper size to (hsize,vsize), a comma-separated -pair of dimensions such as ‘.1in,-.3cm’ (see papersize special). It overrides any paper size special in the DVI file. Be +pair of dimensions such as ‘.1in,-.3cm’ (see 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 ‘-tunknown’.

@@ -1733,10 +1738,9 @@ loaded (if it exists).

Because the .dvipsrc file is read before the printer-specific configuration files, individual users cannot override settings in the -latter. On the other hand, the TEXCONFIG path usually includes -the current directory, and can in any case be set to anything, so the -users can always define their own printer-specific configuration files -to be found before the system’s. +latter. On the other hand, the TEXCONFIG path can be set to +anything, so the users can always define their own printer-specific +configuration files to be found before the system’s.

A few command-line options are treated specially, in that they are not overridden by configuration files: @@ -1793,12 +1797,12 @@ There is no provision for continuation lines.

@ name hsize vsize
-
+

Define paper sizes. See Config file paper sizes.

a*
-
+

Memory conservation. Same as ‘-a’, see Option details.

@@ -1808,7 +1812,7 @@ There is no provision for continuation lines.

c filename
-
+

Include filename as an additional configuration file, read immediately.

@@ -1842,18 +1846,18 @@ be printed if the option is used (and warnings are not suppressed).

G*
-
+

Shift low-numbered characters; obsolete. Same as ‘-G’, see Option details.

h header
-
+

Prepend header to output. Same as ‘h-’, see Option details.

H path
-
+

Use path to search for PostScript header files. The environment @@ -1871,11 +1875,17 @@ variable DVIPSHEADERS overrides this.

K*
-
+

Remove comments from included PostScript files. Same as ‘-K’, see Option details.

+
L*
+
+

If zero, the first paper size specified is effective, else the last. +Same as ‘-L’, see Option details. +

+
m num
@@ -1916,14 +1926,14 @@ splitting of the output is desirable. The Dvips config file

N*
-
+

Disable structured comments. Beware: This also turns off displaying page numbers or changing to specific pagenumbers in PostScript viewers. Same as ‘-N’, see Option details.

o name
-
+

Send output to name. Same as ‘-o’, see Option details. In the file config.foo, a setting like this is probably @@ -1937,7 +1947,7 @@ program by that name in the current directory or along the PATH.

O xoff,yoff
-
+

Origin offset. Same as ‘-O’, see Option details.

@@ -1979,7 +1989,7 @@ environment variables override this. See +
@@ -2008,7 +2018,7 @@ the Makefile variable ‘default_texsizes’, defined in th

s*
-
+

Output global save/restore. Same as ‘-s’, see Option details.

@@ -2045,7 +2055,7 @@ different devices.

W [string]
-
+

If string is supplied, write it to standard error after reading all the configuration files; with no string, cancel any previous @@ -2065,7 +2075,7 @@ about special characteristics of a particular printer.

Z*
-
+

Compress bitmap fonts. Same as ‘-Z’ (see Option details).

@@ -2091,19 +2101,19 @@ Next:

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.

-

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 @@ -2117,7 +2127,7 @@ printer drivers. not and should not attempt to override it manually.

- @@ -2150,7 +2160,7 @@ namely, in (inches), cm (centimeters), mm (millimeters), pt (points), sp unit), pc (picas), dd (didot points), and cc (ciceros).

-

For a US letter size landscape document, the papersize would be: +

For a US letter size landscape document, the ‘papersize’ would be:

\special{papersize=11in,8.5in}
 
@@ -2161,27 +2171,33 @@ unit), pc (picas), dd (didot points), and cc (ciceros).

This is supported for backward compatibility, but it is hoped that -reventually the papersize comment will dominate. +reventually the ‘papersize’ comment will dominate.

Of course, such a \special only informs Dvips of the desired paper 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 +

When using the ‘papersize’ special, you generally should not also specify -t on the command line (see 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 ‘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. +


4.2 Configuration file paper size command

@@ -3496,13 +3512,7 @@ CTAN info, see http://www.win.tue.nl/~dickie/idvi, -and/or in http://www.emrg.com/texpdf.html, which describes -the process of making PDF files from TeX files in more detail. -

-

Mail archives for the original project are at -http://math.albany.edu:8800/hm/ht/. +via the CTAN reference above.

@@ -3588,7 +3598,7 @@ use this character code for characters other than space (notably the Greek letter psi in the Symbol font), and so these characters are dropped. This bug is fixed in version 2.1.

-

If you can’t upgrade, One workaround is to change all the trailing +

If you can’t upgrade, one workaround is to change all the trailing blanks in strings to a character code that isn’t in the font. This works because the default behavior is to substitute a blank for a missing character, i.e., the distiller is fooled into substituting the right @@ -5597,6 +5607,7 @@ Previous: , Up: -j for partial font downloading:

+ @@ -5681,7 +5692,7 @@ Previous: , Up: =: ligature operation: - + @@ -5704,7 +5715,7 @@ Previous: , Up: | starting output filename: - + @@ -5755,7 +5766,7 @@ Previous: , Up: bounding box, supplying to TeX: - + @@ -5911,7 +5922,7 @@ Previous: , Up: fonts, system PostScript: - + @@ -5926,8 +5937,8 @@ Previous: , Up: gsftopk: - - + + @@ -5976,14 +5987,15 @@ Previous: , Up: Jeffrey, Alan: - + + - + @@ -6045,7 +6057,7 @@ Previous: , Up: Murphy, Tim: - + @@ -6054,8 +6066,8 @@ Previous: , Up: nopaper, paper format for ‘-t: - - + + @@ -6091,8 +6103,9 @@ Previous: , Up: paper size, general: - + + @@ -6162,8 +6175,8 @@ Previous: , Up: quiet operation: + - @@ -6182,8 +6195,8 @@ Previous: , Up: rwi (‘psfile’ special option): + - @@ -6262,7 +6275,7 @@ Previous: , Up: uncollated copies: - + @@ -6290,7 +6303,7 @@ Previous: , Up: vsize (‘psfile’ special option): - + @@ -6304,7 +6317,7 @@ Previous: , Up: Y config command (vertical resolution): - + @@ -6393,7 +6406,6 @@ Previous: , Up: