home *** CD-ROM | disk | FTP | other *** search
/ OpenStep 3.3J / os33j.iso / NextLibrary / TeX / tex / src / dvips / vms / dvips.rnh < prev    next >
Encoding:
Text File  |  1993-01-24  |  15.8 KB  |  533 lines
  1. .RM 68
  2. .NO NUMBER
  3. .NO PAGING
  4. .STHL 5,1,1
  5. .lm 0
  6. 1  DVIPS
  7. .lm 2
  8. The dvips  program converts a TEX dvi file into a PostScript file for
  9. printing or distribution.  Seldom has such a seemingly easy programming task
  10. required so much effort. The dvips program has a number of features that set
  11. it apart from other PostScript drivers for TEX.  The dvips driver generates
  12. excellent, standard PostScript, that can be included in other documents as
  13. figures or printed through a variety of spoolers.  The generated PostScript
  14. requires very little printer memory, so very complex documents with a lot of
  15. fonts can easily be printed even on PostScript printers without much memory,
  16. such as the original Apple LaserWriter.  The PostScript output is also
  17. compact, requiring less disk space to store and making it feasible as a
  18. transfer format.
  19. .skip 1
  20. Missing fonts can be automatically generated if METAFONT exists on the
  21. system, or fonts can be converted from gf to pk   format on demand.  If a
  22. font cannot be generated, a scaled version of the same font at a different
  23. size can be used instead, although dvips  will complain loudly about the
  24. poor aesthetics of the resulting output.
  25. .skip 1
  26. .literal
  27.     usage:
  28.          DVIPS filename[.dvi]
  29. .end literal
  30. .skip 1
  31. .lm 0
  32. 2 Parameters
  33. .s
  34. .lm 2
  35. Filename
  36. .s
  37. Specifies the name of the .DVI file that is to be processed.
  38. .lm 0
  39. 2 Command__Qualifiers
  40. .skip 1
  41. /COPIES
  42. .lm 6
  43. .skip 1
  44. /COPIES=num
  45. .lm 2
  46. .skip 1
  47.     Generate num copies of every page.  Default is 1.
  48.     (For collated copies, see the /COLLATE option.)
  49. .skip 1
  50. .lm 0
  51. /DEBUG
  52. .skip 1
  53. .lm 6
  54.     /DEBUG=num
  55. .lm 2
  56. .skip 1
  57.     Set  the  debug  flags.  This  is  intended  only  for
  58.     emergencies  or  for  unusual  fact-finding  expeditions;  it
  59.     will  work  only  if  dvips    has  been  compiled  with  the
  60.     DEBUG option.  Use
  61. .skip 1
  62. .literal
  63.         num=1   for special
  64.  
  65.         num=2   for paths
  66.  
  67.         num=4   for fonts
  68.  
  69.         num=8   for pages
  70.  
  71.         num=16  for headers
  72.  
  73.         num=32  for font compression
  74.  
  75.         num=64  for files
  76.  
  77.         num=128 for memory allocation
  78. .end literal
  79. .skip 1
  80.       Use a value of -1 for maximum output.
  81. .skip 1
  82. .lm 0
  83. /MAXDRIFT
  84. .skip 1
  85. .lm 6
  86.     /MAXDRIFT=num
  87. .lm 2
  88. .skip 1
  89.     Make sure that each character is placed at most this many pixels
  90.     from its `true' resolution-independent position on the page.  The
  91.     default value of this parameter is resolution dependent (it is the
  92.     number of entries in the list [100, 200, 300, 400, 500, 600, 800,
  93.     1000, 1200, 1600, 2000, 2400, 2800, 3200, : : :] that are less
  94.     than or equal to the resolution in dots per inch).  Allowing
  95.     individual characters to `drift' from their correctly rounded
  96.     positions by a few pixels, while regaining the true position at
  97.     the beginning of each new word, improves the spacing of letters in
  98.     words.
  99. .skip 1
  100. .lm 0
  101. /FILTER
  102. .skip 1
  103. .lm 2
  104. Run  as  a  filter.  Read  the  dvi   file  from  standard  input and  write 
  105. the  PostScript  to standard output.  The standard input must be seekable, so
  106. it cannot be a pipe.  If you must use a pipe, write a shell script that copies
  107. the pipe output to a temporary file and then points dvips    at this file.  i-h
  108. name: Prepend file name as an additional header file.  (However,  if the name
  109. is simply `- ',  suppress all header files from the output.) This header file
  110. gets added to the PostScript userdict.
  111. .skip 1
  112. .lm 0
  113. /LAST
  114. .skip 1
  115. .lm 6
  116.     /LAST=num
  117. .lm 2
  118. .skip 1
  119.     The last page printed will be the first one numbered num.  Default
  120.     is the last page in the document.
  121. .skip 1
  122. If the /ABSOLUTE qualifier has been used then it (and any argument to the
  123. /START qualifier)  is treated as a sequence number, rather than a value to
  124. compare with \count0 values.  Thus, using /LAST=9/ABSOLUTE will end with
  125. the ninth page of the document, no matter what the pages are actually
  126. numbered.
  127. .skip 1
  128. .lm 0
  129. /MANUAL
  130. .skip 1
  131. .lm 2
  132.    Specify manual feed for printer.
  133. .skip 1
  134. .lm 0
  135. /NUMBER
  136. .skip 1
  137. .lm 6
  138.      /NUMBER=num
  139. .lm 2
  140. .skip 1
  141.      At most num pages will be printed.  Default is 100000.
  142. .skip 1
  143. .lm 0
  144. /OUTPUT
  145. .skip 1
  146. .lm 6
  147.      /OUTPUT=filename.ext
  148. .lm 2
  149. .skip 1
  150.     The output will be sent to file name.  If no file name is given,
  151.     the default name is file.ps   where the dvi   file was called
  152.     file.dvi .
  153. .skip 1
  154. .lm 0
  155. /START
  156. .skip 1
  157. .lm 6
  158.      /START=num
  159. .lm 2
  160. .skip 1
  161.     The  first  page  printed  will  be  the  first  one  numbered
  162.     num.  Default  is  the  first page in the document.
  163. .skip 1
  164. If the /ABSOLUTE qualifier has been used then it (and any argument to the
  165. /LAST qualifier)  is treated as a sequence number, rather than a value to
  166. compare with \count0 values.  Thus, using /START=3/ABSOLUTE will start with
  167. the third page of the document, no matter what the pages are actually
  168. numbered.
  169. .skip 1
  170. .lm 0
  171. /QUIET
  172. .skip 1
  173. .lm 2
  174.     Run  in  quiet  mode.   Don't  chatter  about  pages  converted,
  175.     etc.;  report  nothing  but errors to standard error.
  176. .skip 1
  177. .lm 0
  178. /REVERSE
  179. .skip 1
  180. .lm 2
  181.     Stack pages in reverse order.  Normally, page 1 will be printed
  182.     first.
  183. .skip 1
  184. .lm 0
  185. /SAV__RES
  186. .skip 1
  187. .lm 2
  188.     Causes the entire global output to be enclosed in a save/restore
  189.     pair.  This causes the file to not be truly conformant, and is
  190.     thus not recommended, but is useful if you are driving the printer
  191.     directly and don't care too much about the portability of the
  192.     output.
  193. .skip 1
  194. .lm 0
  195. /MODE
  196. .skip 1
  197. .lm 6
  198.     /MODE=modename
  199. .lm 2
  200. .skip 1
  201.     This sets the paper mode to modename.  Currently, the only modes
  202.     allowable are
  203. .skip 1
  204. .literal
  205.     "letter", which selects an 8.5 by 11 inch page,
  206.     "a3", which selects an a3 sized page,
  207.     "a4" , which selects an a4 sized page,
  208.     "legal", which selects an 8.5 by 14 inch page,
  209.     "ledger", which selects an 11 by 17 inch page, and
  210.     "landscape", which rotates a letter size document by 90 degrees.
  211. .end literal
  212. .skip 1
  213.     WARNING: always include paper format between quotation marks!
  214. .skip 1
  215.     The default mode is "letter". The  upper left corner of each page in
  216.     the dvi file is placed one inch from the left and one inch from the top.
  217. .skip 1
  218.     If you want to  specify a paper  format (e.g.  a4) AND landscape
  219.     mode, you must use something like
  220. .literal
  221.           /MODE=("landscape","a4")
  222. .end literal
  223.     putting "landscape" as the first value.
  224. .skip 1
  225. .lm 0
  226. /MAGNIFICATION
  227. .skip 1
  228. .lm 6
  229.     /MAGNIFICATION=num
  230. .lm 2
  231. .skip 1
  232.     Set the magnification ratio to num/1000.  Overrides the
  233.     magnification specified in the dvi   file.  Must be between 10 and
  234.     100000.
  235. .skip 1
  236. .lm 0
  237. /COLLATE
  238. .skip 1
  239. .lm 6
  240.     /COLLATE=num
  241. .lm 2
  242. .skip 1
  243.     Create num copies, but collated (by replicating the data in the
  244.     PostScript file). Slower than the /COPIES option, but easier on
  245.     the hands, and faster than resubmitting the same PostScript file
  246.     multiple times.
  247. .skip 1
  248. .lm 0
  249. /DPI
  250. .skip 1
  251. .lm 6
  252.     /DPI=num
  253. .lm 2
  254. .skip 1
  255.     Set  the  resolution  in  dpi  (dots  per  inch)  to  num.   This
  256.     affects  the  choice  of bitmap fonts that are loaded and also the
  257.     positioning of letters in resident PostScript fonts.  Must be
  258.     between 10 and 10000.  This affects both the horizontal and
  259.     vertical resolution.  If a high resolution (something greater than
  260.     400 dpi, say) is selected, the /COMPRESS flag should probably also
  261.     be used.
  262. .skip 1
  263. .lm 0
  264. /CTRL__D
  265. .skip 1
  266. .lm 2
  267.     Causes  Control-D  (ASCII  code  4)  to  be  appended  as  the
  268.     very  last  character  of  the PostScript file.  This is useful
  269.     when dvips     is driving the printer directly instead of working
  270.     through a spooler, as is common on extremely small systems.
  271.     Otherwise, it is not recommended.
  272. .skip 1
  273. .lm 0
  274. /INC__COM
  275. .skip 1
  276. .lm 6
  277.      /INC__COM (default)
  278. .break
  279.      /NOINC__COM
  280. .lm 2
  281. .skip 1
  282.     /NOINC__COM option causes comments in included PostScript graphics,
  283.     font files, and headers to be removed.  This is sometimes
  284.     necessary to get around bugs in spoolers or PostScript
  285.     post-processing  programs.   Specifically,  the  %%Page comments,
  286.     when  left  in,  often cause difficulties.  Use of this flag can
  287.     cause some included graphics to fail, since the PostScript  header
  288.     macros  from  some  software  packages  read  portions  of  the
  289.     input stream line by line, searching for a particular comment.
  290. .skip 1
  291. .lm 0
  292. /COMMENT
  293. .skip 1
  294. .lm 6
  295.    /COMMENT (default)
  296. .break
  297.    /NOCOMMENT
  298. .lm 2
  299. .skip 1
  300.     /NOCOMMENT turns off structured comments;  this might be necessary
  301.     on some systems that try to interpret PostScript comments in weird
  302.     ways, or on some PostScript printers.  Old versions of Transcript
  303.     in particular cannot handle modern Encapsulated PostScript.
  304. .skip 1
  305. .lm 0
  306. /PRINTER
  307. .skip 1
  308. .lm 6
  309.     /PRINTER=printername
  310. .lm 2
  311. .skip 1
  312.     Sets  up  the  output  for  the  appropriate  printer. This is
  313.     implemented  by  reading  in  config.printername , which can set
  314.     various parameters such  as the font paths and any other defaults
  315.     for that printer only.  It is recommended that all standard
  316.     defaults go in the one master config.ps file and only things that
  317.     vary printer to printer go in the config.printername files. Note
  318.     that  config.ps  is  read  before  config.printername. In
  319.     addition,  another file called "/.dvipsrc   is searched for
  320.     immediately after config.ps;  this file is intended for user
  321.     defaults.  If no /PRINTER command is given, the environment
  322.     variable PRINTER is  checked.  If  that  variable  exists,  and  a
  323.     corresponding  configuration  file exists, that configuration file
  324.     is read in.
  325. .skip 1
  326. .lm 0
  327. /VM__SAVE
  328. .skip 1
  329. .lm 6
  330.      /VM__SAVE (default)
  331. .break
  332.      /NOVM__SAVE
  333. .lm 2
  334. .skip 1
  335. /NOVM__SAVE disables a PostScript virtual memory saving optimization that 
  336. stores the character metric information in the same string that is used  to
  337. store the bitmap information.  This is only necessary when driving the  Xerox
  338. 4045 PostScript interpreter, and it is caused by a bug in that interpreter that
  339. results in `garbage' on the bottom of each character. Not recommended unless
  340. you must drive this printer.
  341. .skip 1
  342. .lm 0
  343. /H__DPI
  344. .skip 1
  345. .lm 6
  346. /H__DPI=num
  347. .lm 2
  348. .skip 1
  349. Set the horizontal resolution in dots per inch to num.
  350. .skip 1
  351. .lm 0
  352. /V__DPI
  353. .skip 1
  354. .lm 6
  355. /V__DPI=num
  356. .lm 2
  357. .skip 1
  358. Set the vertical resolution in dots per inch to num.
  359. .skip 1
  360. .lm 0
  361. /COMPRESS
  362. .skip 1
  363. .lm 2
  364. Causes bitmapped fonts to be compressed before they are downloaded, thereby
  365. reducing the size of the PostScript font-downloading information.  Especially
  366. useful at high resolutions or when very large fonts are used.  Will slow down
  367. printing somewhat, especially on early 68000-based PostScript printers.
  368. .skip 1
  369. .lm 0
  370. .!-----------------------------------------------------------------------
  371. .! New stuff for version 5.497
  372. .!-----------------------------------------------------------------------
  373. /HEADER
  374. .skip 1
  375. .lm 6
  376. /HEADER=file-spec
  377. .break
  378. /NOHEADER
  379. .lm 2
  380. .skip 1
  381. Prepend file "file-spec" as an additional header file. However, if the name
  382. is simply `-', suppress all header files from the output. Similarly,
  383. /NOHEADER suppress all header files from the output. This header file gets
  384. added to the PostScript userdict. (Corresponds to the -h option)
  385. .skip 1
  386. .lm 0
  387. /ABSOLUTE
  388. .lm 2
  389. .skip 1
  390. If the /ABSOLUTE qualifier has been used then any argument to the /START
  391. and/or /LAST qualifiers are treated as sequence numbers, rather than a
  392. value to compare with \count0 values.  Thus, using /START=3/ABSOLUTE will
  393. start with the third page of the document, no matter what the pages are
  394. actually numbered.
  395. (Corresponds to the -p and -l options)
  396. .skip 1
  397. .lm 0
  398. /EPSF
  399. .lm 2
  400. .skip 1
  401. Makes `dvips' attempt to generate an EPSF file with a tight bounding box. 
  402. This only works on one-page files, and it only looks at marks made by
  403. characters and rules, not by any included graphics.  In addition, it gets
  404. the glyph metrics from the `tfm' file, so characters that lie outside their
  405. enclosing `tfm' box may confuse it.  In addition, the bounding box might be
  406. a bit too loose if the character glyph has significant left or right side
  407. bearings.  Nonetheless, this option works well for creating small EPSF files
  408. for equations or tables or the like. (Note, of course, that `dvips' output
  409. is resolution dependent and thus does not make very good EPSF files,
  410. especially if the images are to be scaled; use these EPSF files with a great
  411. deal of care.)
  412. (Corresponds to the -E option)
  413. .skip 1
  414. .lm 0
  415. /PRESCAN
  416. .lm 2
  417. .skip 1
  418. Conserve memory by making three passes over the `dvi' file instead of two
  419. and only loading those characters actually used. Generally only useful on
  420. machines with a very limited amount of memory, like some PCs.
  421. (Corresponds to the -a option)
  422. .skip 1
  423. .lm 0
  424. /PAGECOPIES
  425. .skip 1
  426. .lm 6
  427. /PAGECOPIES=num
  428. .lm 2
  429. .skip 1
  430. Generate `num' copies of each page, but duplicating the page body rather
  431. than using the `#numcopies' option.  This can be useful in conjunction with
  432. a header file setting \bop-hook to do color separations or other neat
  433. tricks. (Corresponds to the -b option)
  434. .skip 1
  435. .lm 0
  436. /SEPARATE
  437. .skip 1
  438. .lm 2
  439. Make each section be a separate file.  Under certain circumstances,
  440. `dvips' will split the document up into `sections' to be processed
  441. independently; this is most often done for memory reasons.  Using this
  442. option tells `dvips' to place each section into a separate file; the
  443. new file names are created replacing the suffix of the supplied output
  444. file name by a three-digit sequence number.
  445. .break
  446. This option is most often used in conjunction with the /SEC_SIZE qualifier
  447. which sets the maximum section length in pages.  For instance, some
  448. phototypesetters cannot print more than ten or so consecutive pages before
  449. running out of steam; these options can be used to automatically split a
  450. book into ten-page sections, each to its own file. (Corresponds to the -i
  451. option)
  452. .skip 1
  453. .lm 0
  454. /CROPMARKS
  455. .skip 1
  456. .lm 2
  457. Print crop marks.  This option increases the paper size (which should be
  458. specified, either with a paper size special or with the /PSIZE qualifier) by
  459. a half inch in each dimension.  It translates each page by a quarter inch
  460. and draws cross-style crop marks.  It is mostly useful with typesetters that
  461. can set the page size automatically. (Corresponds to the -k option)
  462. .skip 1
  463. .lm 0
  464. /SEC_SIZE
  465. .skip 1
  466. .lm 6
  467. /SEC_SIZE=num
  468. .lm 2
  469. .skip 1
  470. Set the maximum number of pages in each `section'.  This option is most
  471. commonly used with the /SEPARATE qualifier; see that documentation above for
  472. more information. (Corresponds to the -S option)
  473. .skip 1
  474. .lm 0
  475. /HELP
  476. .skip 1
  477. .lm 2
  478. Displays a summary of the comand line options for the DVIPS program, but it
  479. show the UNIX version. Not much use to the VMS people, maybe one day we can
  480. set it to read this help library through the LBR$ utility routines.
  481. (Corresponds to the -? option)
  482. .skip 1
  483. .lm 0
  484. /MAKEFONT
  485. .skip 1
  486. .lm 6
  487. /MAKEFONT (default)
  488. /NOMAKEFONT
  489. .lm 2
  490. By default an attempt is made to make missing fonts. Use of /NOMAKEFONT
  491. turns off the automatic font generation facility.  If any fonts are missing,
  492. commands to generate the fonts are appended to the file  `missfont.log' in
  493. the current directory; this file can then be executed and deleted to create
  494. the missing fonts.
  495. .skip 1
  496. .lm 0
  497. /PSIZE
  498. .skip 1
  499. .lm 6
  500. /PSIZE="xsize,ysize"
  501. .lm 2
  502. .skip 1
  503. Set the paper size to the given pair of dimensions.  This option takes
  504. its arguments in the same style as /POFFSET.  It overrides any paper
  505. size special in the `dvi' file.
  506. .skip 1
  507. Example : /PSIZE="6in,8in"
  508. .skip 1
  509. .lm 0
  510. /POFFSET
  511. .skip 1
  512. .lm 6
  513. /POFFSET="xoffset,yoffset"
  514. .lm 2
  515. .skip 1
  516. Move the origin by a certain amount.  The `offset' is a comma-separated
  517. pair of dimensions, such as ".1in,-.3cm" (in the same syntax used in
  518. the /PSIZE qualifier).   The origin of the page is shifted from the
  519. default position (of one inch down, one inch to the right from the upper
  520. left corner of the paper) by this amount.
  521. .skip 1
  522. Example : /POFFSET=".1in,-.3cm"
  523. .skip 1
  524. .!-----------------------------------------------------------------------
  525. .lm 0
  526. 2 Specials
  527. .skip 1
  528. .lm 2
  529. For a description of the special features of dvips see the dvips manual a LaTeX
  530. version of which may be copied  using the command
  531. .skip 1
  532. copy tex$postscript:dvips.tex dvips.tex
  533.