summaryrefslogtreecommitdiff
path: root/Build/source/texk/dvipsk/vms/dvips.hlp
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/texk/dvipsk/vms/dvips.hlp')
-rw-r--r--Build/source/texk/dvipsk/vms/dvips.hlp435
1 files changed, 0 insertions, 435 deletions
diff --git a/Build/source/texk/dvipsk/vms/dvips.hlp b/Build/source/texk/dvipsk/vms/dvips.hlp
deleted file mode 100644
index 760abc3bac4..00000000000
--- a/Build/source/texk/dvipsk/vms/dvips.hlp
+++ /dev/null
@@ -1,435 +0,0 @@
-1 DVIPS
-
-! Modified 07-Jul-1996 - EJG
-! Fix description of filter (can write to stdout, but not read from stdin!
-! Change mode description, landscape used with others just gives
-! landscape. So took that out. Removed warning about quotes (not
-! necessary). Added tabloid.
-! Changed qualifier ctrl_d to ctrld to agree with cld file
-! Changed default for inc_com to be noinc_com to agree with dvips
-! Fix header qualifier
-!
-! Added comment about the manual to front and also under the
-! special heading.
-
-The dvips program converts a TEX dvi file into a PostScript file for
-printing or distribution. Seldom has such a seemingly easy programming
-task required so much effort. The dvips program has a number of features
-that set it apart from other PostScript drivers for TEX. The dvips
-driver generates excellent, standard PostScript, that can be included in
-other documents as figures or printed through a variety of spoolers. The
-generated PostScript requires very little printer memory, so very complex
-documents with a lot of fonts can easily be printed even on PostScript
-printers without much memory, such as the original Apple LaserWriter. The
-PostScript output is also compact, requiring less disk space to store and
-making it feasible as a transfer format. Missing fonts can be automatically
-generated if METAFONT exists on the system, or fonts can be converted from
-gf to pk format on demand. If a font cannot be generated, a scaled
-version of the same font at a different size can be used instead, although
-dvips will complain loudly about the poor aesthetics of the resulting
-output.
-
-A manual for dvips may be printed with the command:
-
- printps tex_root:[local]dvips.ps
-
-In this manual, the command line options are for the unix variant
-of dvips. Our version has the qualifiers as detailed in this help
-file. Also, some of the latest options are not in the manual (in
-particular, the /hyperps option).
-
- usage:
- DVIPS filename[.dvi]
-
-2 /COPIES
- /COPIES=num
-
- Generate num copies of every page. Default is 1.
- (For collated copies, see the /COLLATE option.)
-
-2 /DEBUG
- /DEBUG=num
-
- Set the debug flags. This is intended only for
- emergencies or for unusual fact-finding expeditions; it
- will work only if dvips has been compiled with the
- DEBUG option. Use
-
- num=1 for special
-
- num=2 for paths
-
- num=4 for fonts
-
- num=8 for pages
-
- num=16 for headers
-
- num=32 for font compression
-
- num=64 for files
-
- num=128 for memory allocation
-
- Use a value of -1 for maximum output.
-
-2 /MAXDRIFT
- /MAXDRIFT=num
-
- Make sure that each character is placed at most this many pixels
- from its `true' resolution-independent position on the page. The
- default value of this parameter is resolution dependent (it is the
- number of entries in the list [100, 200, 300, 400, 500, 600, 800,
- 1000, 1200, 1600, 2000, 2400, 2800, 3200, : : :] that are less
- than or equal to the resolution in dots per inch). Allowing
- individual characters to `drift' from their correctly rounded
- positions by a few pixels, while regaining the true position at
- the beginning of each new word, improves the spacing of letters in
- words.
-
-2 /FILTER
-
- Run as a filter writing the output to the standard output.
- (The input must still be specified as the argument.)
-
-2 /LAST
- /LAST=num
-
- The last page printed will be the first one numbered num. Default
- is the last page in the document.
-
-
-2 /MANUAL
-
- Specify manual feed for printer.
-
-2 /NUMBER
- /NUMBER=num
- At most num pages will be printed. Default is 100000.
-
-2 /OUTPUT
- /OUTPUT=filename.ext
-
- The output will be sent to file name. If no file name is given,
- the default name is file.ps where the dvi file was called
- file.dvi .
-
-2 /START
- /START=num
-
- The first page printed will be the first one numbered
- num. Default is the first page in the document.
-
-2 /QUIET
-
- Run in quiet mode. Don't chatter about pages converted,
- etc.; report nothing but errors to standard error.
-
-2 /REVERSE
-
- Stack pages in reverse order. Normally, page 1 will be printed
- first.
-
-2 /SAV_RES
-
- Causes the entire global output to be enclosed in a save/restore
- pair. This causes the file to not be truly conformant, and is
- thus not recommended, but is useful if you are driving the printer
- directly and don't care too much about the portability of the
- output.
-
-2 /MODE
- /MODE=modename
-
- This sets the paper mode to modename. Currently, the only modes
- allowable are
-
- "letter", which selects an 8.5 by 11 inch page,
- "a3", which selects an a3 sized page,
- "a4" , which selects an a4 sized page,
- "legal", which selects an 8.5 by 14 inch page,
- "ledger", which selects an 11 by 17 inch page, and
- "tabloid", which selects a 17 by 11 inch page, and
- "landscape", which rotates a letter size document by 90 degrees.
-
-
- The default mode is "letter". The upper left corner of each page in
- the dvi file is placed one inch from the left and one inch from the top.
-
-2 /MAGNIFICATION
- /MAGNIFICATION=num
-
- Set the magnification ratio to num/1000. Overrides the
- magnification specified in the dvi file. Must be between 10 and
- 100000.
-
-2 /COLLATE
- /COLLATE=num
-
- Create num copies, but collated (by replicating the data in the
- PostScript file). Slower than the /COPIES option, but easier on
- the hands, and faster than resubmitting the same PostScript file
- multiple times.
-
-2 /DPI
- /DPI=num
-
- Set the resolution in dpi (dots per inch) to num. This
- affects the choice of bitmap fonts that are loaded and also the
- positioning of letters in resident PostScript fonts. Must be
- between 10 and 10000. This affects both the horizontal and
- vertical resolution. If a high resolution (something greater than
- 400 dpi, say) is selected, the /COMPRESS flag should probably also
- be used.
-
-2 /CTRLD
-
- Causes Control-D (ASCII code 4) to be appended as the
- very last character of the PostScript file. This is useful
- when dvips is driving the printer directly instead of working
- through a spooler, as is common on extremely small systems.
- Otherwise, it is not recommended.
-
-2 /INC_COM
- /INC_COM
- /NOINC_COM (default)
-
- /NOINC_COM option causes comments in included PostScript graphics,
- font files, and headers to be removed. This is sometimes
- necessary to get around bugs in spoolers or PostScript
- post-processing programs. Specifically, the %%Page comments,
- when left in, often cause difficulties. Use of this flag can
- cause some included graphics to fail, since the PostScript header
- macros from some software packages read portions of the
- input stream line by line, searching for a particular comment.
-
-2 /COMMENT
- /COMMENT (default)
- /NOCOMMENT
-
- /NOCOMMENT turns off structured comments; this might be necessary
- on some systems that try to interpret PostScript comments in weird
- ways, or on some PostScript printers. Old versions of Transcript
- in particular cannot handle modern Encapsulated PostScript.
-
-2 /PRINTER
- /PRINTER=printername
-
- Sets up the output for the appropriate printer. This is
- implemented by reading in config.printername , which can set
- various parameters such as the font paths and any other defaults
- for that printer only. It is recommended that all standard
- defaults go in the one master config.ps file and only things that
- vary printer to printer go in the config.printername files. Note
- that config.ps is read before config.printername. In
- addition, another file called "/.dvipsrc is searched for
- immediately after config.ps; this file is intended for user
- defaults. If no /PRINTER command is given, the environment
- variable PRINTER is checked. If that variable exists, and a
- corresponding configuration file exists, that configuration file
- is read in.
-
-2 /HEADER
- /HEADER=(file1,file2,...)
- /NOHEADER
-
- Prepend file1, file2, ... as additional header files.
- This header file gets added to the PostScript userdict.
- With /NOHEADER, suppress all header output.
-
-
-2 /VM_SAVE
- /VM_SAVE (default)
- /NOVM_SAVE
-
- /NOVM_SAVE disables a PostScript virtual memory saving
- optimization that stores the character metric information in the
- same string that is used to store the bitmap information. This
- is only necessary when driving the Xerox 4045 PostScript
- interpreter, and it is caused by a bug in that interpreter that
- results in `garbage' on the bottom of each character. Not
- recommended unless you must drive this printer.
-
-2 /H_DPI
- /H_DPI=num
-
- Set the horizontal resolution in dots per inch to num.
-
-
-2 /V_DPI
- /V_DPI=num
-
- Set the vertical resolution in dots per inch to num.
-
-2 /COMPRESS
-
- Causes bitmapped fonts to be compressed before they are
- downloaded, thereby reducing the size of the PostScript
- font-downloading 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.
-
-2 /ABSOLUTE
-
- Makes references to page numbers absolute (rather than TeX
- page numbers).
-
-2 /EPSF
- /EPSF
- /NOEPSF (default)
-
- /EPSF makes dvips attempt to generate an EPSF file with a
- tight bounding box. This only works on one-page files, and it
- only looks at marks made by characters and rules, not by any
- included graphics. In addition, it gets the glyph metrics
- from the tfm file, so characters that lie outside their
- enclosing tfm box may confuse it. In addition, the bounding
- box might be a bit too loose if the character glyph has
- significant left or right side bearings. Nonetheless, this
- option works well for creating small EPSF files for equations
- or tables or the like. (Note, of course, that dvips output is
- resolution dependent and thus does not make very good EPSF
- files, especially if the images are to be scaled; use these
- EPSF files with a great deal of care.)
-
-
-2 /PRESCAN
- /PRESCAN
- /NOPRESCAN (default)
-
- Conserve memory by making three passes over the .dvi file
- instead of two and only loading those characters actually
- used. Generally only useful on machines with a very limited
- amount of memory, like some PCs.
-
-2 /PAGECOPIES
- /PAGECOPIES=num (default=1)
-
- Number of times to print each page. Executes the postscript
- for each page this number of times (unlike /COPIES which
- executes the postscript once and prints multiple times.)
-
-2 /SEPARATE
- /SEPARATE
- /NOSEPARATE (default)
-
- Make each section be a separate file. Under certain
- circumstances, dvips will split the document up into
- `sections' to be processed independently; this is most often
- done for memory reasons. Using this option tells dvips to
- place each section into a separate file; the new file names
- 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 /SEC_SIZE option which
- sets the maximum section length in pages. For instance, some
- phototypesetters cannot print more than ten or so consecutive
- pages before running out of steam; these options can be used
- to automatically split a book into ten-page sections, each to
- its own file.
-
-2 /CROPMARKS
- /CROPMARKS
- /NOCROPMARKS (default)
-
- Print crop marks. This option increases the paper size
- (which should be specified, either with a paper size special
- or with the /PSIZE option) by a half inch in each dimension.
- It translates each page by a quarter inch and draws
- cross-style crop marks. It is mostly useful with typesetters
- that can set the page size automatically.
-
-
-2 /SEC_SIZE
- /SEC_SIZE=number
-
- Set the maximum number of pages in each `section'. This
- option is most commonly used with the /SEPARATE option; see
- that documentation above for more information.
-
-
-2 /HELP
- /HELP
-
- Given with a dummy file name, causes dvips to output a one
- page listing of options in unix form. Not very useful!
-
-
-
-2 /MAKEFONT
- /MAKEFONT (default)
- /NOMAKEFONT
-
- The /NOMAKEFONT option turns off the automatic font
- generation facility. If any fonts are missing, commands to
- generate the fonts are appended to the file missfont.log in
- the current directory; this file can then be executed and
- deleted to create the missing fonts.
-
-2 /PSIZE
- /PSIZE="dim,dim"
-
- Set the paper size to the given pair of dimensions. This
- option takes its arguments in the same syntax as the
- papersize special, for example 8.5in,11in. It overrides any
- paper size special in the dvi file. The dimensions must
- resolve to a papersize specified in the configuration files.
-
-
-2 /POFFSET
- /POFFSET="dim,dim"
-
- Move the origin by a certain amount. The offset is a
- comma-separated pair of dimensions, such as .1in,-.3cm (in
- the same syntax used in the 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.
-
-
-2 /SECURE
- /SECURE
- /NOSECURE (default)
-
- With the /SECURE option, dvips will not attempt to open pipes
- or run commands (such as commands to make fonts).
-
-2 /ODDPAGES
- /ODDPAGES
- /NOODDPAGES (default)
-
- Print only odd pages (TeX pages, not sequence pages).
-
-2 /EVENPAGES
- /EVENPAGES
- /NOEVENPAGES (default)
-
- Print only even pages (TeX pages, not sequence pages).
-
-2 /DOWNLOADPS
- /DOWNLOADPS
- /NODOWNLOADPS (default)
-
- Downloadable postscript fonts are set in PK (compressed
- bitmap) format.
-
-2 /HYPERPS
- /HYPERPS
- /NOHYPERPS (default)
-
- Outputs \specials containing hyperlinks to the output file as
- pdf marks embedded in postscript comments. These can then be
- turned into hyperlinks with Adobe Distiller and viewed with
- Adobe Acrobat.
-
-2 Specials
-
- The specials are described in the manual which may be printed
- with the command
-
- printps tex_root:[local]dvips.ps
-
- In this manual, the command line options are for the unix
- variant of dvips. Our version has the qualifiers as detailed
- in this help file. Also, some of the latest options are not
- in the manual (in particular, the /hyperps option).