home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3.4.17 [SPARC, PA-RISC] / nextstep33_risc.iso / NextLibrary / TeX / tex / src / dvips / vms / dvips.hlp < prev    next >
Text File  |  1992-03-27  |  9KB  |  262 lines
  1. 1  DVIPS
  2.  
  3. The dvips  program converts a TEX dvi file into a PostScript file for
  4. printing or distribution.  Seldom has such a seemingly easy programming
  5. task required so much effort. The dvips program has a number of features
  6. that set it apart from other PostScript drivers for TEX.  The dvips   
  7. driver generates excellent, standard PostScript, that can be included in
  8. other documents as figures or printed through a variety of spoolers.  The
  9. generated PostScript requires very little printer memory, so very complex
  10. documents with a lot of fonts can easily be printed even on PostScript
  11. printers without much memory, such as the original Apple LaserWriter.  The
  12. PostScript output is also compact, requiring less disk space to store and
  13. making it feasible as a transfer format. Missing fonts can be automatically
  14. generated if METAFONT exists on the system, or fonts can be converted from
  15. gf to pk   format on demand.  If a font cannot be generated, a scaled
  16. version of the same font at a different size can be used instead, although
  17. dvips  will complain loudly about the poor aesthetics of the resulting
  18. output.
  19.  
  20.     usage:
  21.          DVIPS filename[.dvi]
  22.  
  23. 2 /COPIES
  24.     /COPIES=num
  25.     
  26.     Generate num copies of every page.  Default is 1. 
  27.     (For collated copies, see the /COLLATE option.)
  28.  
  29. 2 /DEBUG
  30.     /DEBUG=num
  31.     
  32.     Set  the  debug  flags.  This  is  intended  only  for 
  33.     emergencies  or  for  unusual  fact-finding  expeditions;  it 
  34.     will  work  only  if  dvips    has  been  compiled  with  the 
  35.     DEBUG option.  Use
  36.  
  37.         num=1   for special
  38.         
  39.         num=2   for paths
  40.  
  41.         num=4   for fonts
  42.  
  43.         num=8   for pages
  44.  
  45.         num=16  for headers
  46.  
  47.         num=32  for font compression
  48.  
  49.         num=64  for files
  50.  
  51.         num=128 for memory allocation
  52.  
  53.       Use a value of -1 for maximum output.
  54.  
  55. 2 /MAXDRIFT 
  56.     /MAXDRIFT=num   
  57.  
  58.     Make sure that each character is placed at most this many pixels
  59.     from its `true' resolution-independent position on the page.  The
  60.     default value of this parameter is resolution dependent (it is the
  61.     number of entries in the list [100, 200, 300, 400, 500, 600, 800,
  62.     1000, 1200, 1600, 2000, 2400, 2800, 3200, : : :] that are less
  63.     than or equal to the resolution in dots per inch).  Allowing
  64.     individual characters to `drift' from their correctly rounded
  65.     positions by a few pixels, while regaining the true position at
  66.     the beginning of each new word, improves the spacing of letters in
  67.     words.
  68.  
  69. 2 /FILTER
  70.     
  71.     Run  as  a  filter.  Read  the  dvi   file  from  standard  input 
  72.     and  write  the  PostScript  to standard output.  The standard
  73.     input must be seekable, so it cannot be a pipe.  If you must use a
  74.     pipe, write a shell script that copies the pipe output to a
  75.     temporary file and then points dvips    at this file.  i-h name: 
  76.     Prepend file name as an additional header file.  (However,  if the
  77.     name is simply `- ',  suppress all header files from the output.) 
  78.     This header file gets added to the PostScript userdict.
  79.  
  80. 2 /LAST
  81.     /LAST=num
  82.  
  83.     The last page printed will be the first one numbered num.  Default
  84.     is the last page in the document.
  85.  
  86.  
  87. 2 /MANUAL
  88.  
  89.    Specify manual feed for printer.
  90.  
  91. 2 /NUMBER
  92.      /NUMBER=num
  93.      At most num pages will be printed.  Default is 100000.
  94.  
  95. 2 /OUTPUT
  96.      /OUTPUT=filename.ext
  97.   
  98.     The output will be sent to file name.  If no file name is given,
  99.     the default name is file.ps   where the dvi   file was called
  100.     file.dvi .
  101.  
  102. 2 /START
  103.      /START=num
  104.  
  105.     The  first  page  printed  will  be  the  first  one  numbered 
  106.     num.  Default  is  the  first page in the document.
  107.  
  108. 2 /QUIET
  109.  
  110.     Run  in  quiet  mode.   Don't  chatter  about  pages  converted, 
  111.     etc.;  report  nothing  but errors to standard error.
  112.  
  113. 2 /REVERSE
  114.  
  115.     Stack pages in reverse order.  Normally, page 1 will be printed
  116.     first.
  117.  
  118. 2 /SAV_RES
  119.    
  120.     Causes the entire global output to be enclosed in a save/restore
  121.     pair.  This causes the file to not be truly conformant, and is
  122.     thus not recommended, but is useful if you are driving the printer
  123.     directly and don't care too much about the portability of the
  124.     output.
  125.  
  126. 2 /MODE
  127.     /MODE=modename
  128.  
  129.     This sets the paper mode to modename.  Currently, the only modes
  130.     allowable are 
  131.  
  132.     "letter", which selects an 8.5 by 11 inch page, 
  133.     "a3", which selects an a3 sized page, 
  134.     "a4" , which selects an a4 sized page, 
  135.     "legal", which selects an 8.5 by 14 inch page,
  136.     "ledger", which selects an 11 by 17 inch page, and 
  137.     "landscape", which rotates a letter size document by 90 degrees. 
  138.  
  139.     WARNING: always include paper format between quotation marks!
  140.  
  141.     The default mode is "letter". The  upper left corner of each page in
  142.     the dvi file is placed one inch from the left and one inch from the top.
  143.  
  144.     If you want to  specify a paper  format (e.g.  a4) AND landscape
  145.     mode, you must use something like  
  146.                                         /MODE=("landscape","a4")
  147.     putting "landscape" as the first value.
  148.  
  149. 2 /MAGNIFICATION
  150.     /MAGNIFICATION=num
  151.  
  152.     Set the magnification ratio to num/1000.  Overrides the
  153.     magnification specified in the dvi   file.  Must be between 10 and
  154.     100000.
  155.  
  156. 2 /COLLATE
  157.     /COLLATE=num
  158.      
  159.     Create num copies, but collated (by replicating the data in the
  160.     PostScript file). Slower than the /COPIES option, but easier on
  161.     the hands, and faster than resubmitting the same PostScript file
  162.     multiple times.
  163.  
  164. 2 /DPI
  165.     /DPI=num
  166.  
  167.     Set  the  resolution  in  dpi  (dots  per  inch)  to  num.   This 
  168.     affects  the  choice  of bitmap fonts that are loaded and also the
  169.     positioning of letters in resident PostScript fonts.  Must be
  170.     between 10 and 10000.  This affects both the horizontal and
  171.     vertical resolution.  If a high resolution (something greater than
  172.     400 dpi, say) is selected, the /COMPRESS flag should probably also
  173.     be used.
  174.  
  175. 2 /CTRL_D
  176.  
  177.     Causes  Control-D  (ASCII  code  4)  to  be  appended  as  the 
  178.     very  last  character  of  the PostScript file.  This is useful
  179.     when dvips     is driving the printer directly instead of working
  180.     through a spooler, as is common on extremely small systems. 
  181.     Otherwise, it is not recommended.
  182.  
  183. 2 /INC_COM
  184.      /INC_COM (default)
  185.      /NOINC_COM
  186.  
  187.     /NOINC_COM option causes comments in included PostScript graphics,
  188.     font files, and headers to be removed.  This is sometimes
  189.     necessary to get around bugs in spoolers or PostScript
  190.     post-processing  programs.   Specifically,  the  %%Page comments, 
  191.     when  left  in,  often cause difficulties.  Use of this flag can
  192.     cause some included graphics to fail, since the PostScript  header 
  193.     macros  from  some  software  packages  read  portions  of  the 
  194.     input stream line by line, searching for a particular comment. 
  195.  
  196. 2 /COMMENT
  197.    /COMMENT (default)
  198.    /NOCOMMENT
  199.    
  200.     /NOCOMMENT turns off structured comments;  this might be necessary
  201.     on some systems that try to interpret PostScript comments in weird
  202.     ways, or on some PostScript printers.  Old versions of Transcript
  203.     in particular cannot handle modern Encapsulated PostScript.
  204.  
  205. 2 /PRINTER
  206.     /PRINTER=printername
  207.  
  208.     Sets  up  the  output  for  the  appropriate  printer. This is
  209.     implemented  by  reading  in  config.printername , which can set
  210.     various parameters such  as the font paths and any other defaults
  211.     for that printer only.  It is recommended that all standard
  212.     defaults go in the one master config.ps file and only things that
  213.     vary printer to printer go in the config.printername files. Note 
  214.     that  config.ps  is  read  before  config.printername. In 
  215.     addition,  another file called "/.dvipsrc   is searched for
  216.     immediately after config.ps;  this file is intended for user
  217.     defaults.  If no /PRINTER command is given, the environment
  218.     variable PRINTER is  checked.  If  that  variable  exists,  and  a 
  219.     corresponding  configuration  file exists, that configuration file
  220.     is read in.
  221.  
  222.  
  223. 2 /VM_SAVE       
  224.      /VM_SAVE (default)
  225.      /NOVM_SAVE
  226.     
  227.     /NOVM_SAVE disables a PostScript virtual memory saving
  228.     optimization that  stores the character metric information in the
  229.     same string that is used  to store the bitmap information.  This
  230.     is only necessary when driving the  Xerox 4045 PostScript
  231.     interpreter, and it is caused by a bug in that interpreter that
  232.     results in `garbage' on the bottom of each character. Not
  233.     recommended unless you must drive this printer.
  234.  
  235. 2 /H_DPI
  236.      /H_DPI=num
  237.  
  238.     Set the horizontal resolution in dots per inch to num.
  239.  
  240.  
  241. 2 /V_DPI
  242.      /V_DPI=num
  243.  
  244.     Set the vertical resolution in dots per inch to num.
  245.  
  246. 2 /COMPRESS
  247.  
  248.     Causes bitmapped fonts to be compressed before they are
  249.     downloaded, thereby reducing the size of the PostScript
  250.     font-downloading information.  Especially useful at high
  251.     resolutions or when very large fonts are used.  Will slow down
  252.     printing somewhat, especially on early 68000-based PostScript
  253.     printers.
  254.  
  255. 2 Specials 
  256.  
  257.     For a description of the special features of dvips see the dvips
  258.     manual a LaTeX version of which may be copied  using the command
  259.     
  260.      copy tex$postscript:dvips.tex dvips.tex
  261.  
  262.