home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fonts 1 / freshfonts1.bin / bbs / programs / amiga / pastex13.lha / DVIPS / dvips5519.lha / dvips / vms / dvips.rnh < prev    next >
Text File  |  1993-01-24  |  16KB  |  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.     ma