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, 435 insertions, 0 deletions
diff --git a/Build/source/texk/dvipsk/vms/dvips.hlp b/Build/source/texk/dvipsk/vms/dvips.hlp
new file mode 100644
index 00000000000..760abc3bac4
--- /dev/null
+++ b/Build/source/texk/dvipsk/vms/dvips.hlp
@@ -0,0 +1,435 @@
+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).