home *** CD-ROM | disk | FTP | other *** search
/ PD Collection CD 1 / PD Collection CD 1.iso / textual / tex / files / !tex / TeXsource / beebe / info / dvi
Encoding:
Text File  |  1987-01-21  |  37.0 KB  |  866 lines

  1. -*-Text-*-
  2. ***WARNING***:  Do NOT edit this file.  It was created automatically from
  3. the corresponding .ULP file
  4.     APS:<TEX.DVI>DVI.HLP.26,26-Dec-86 12:12:06
  5. by the EMACS command M-X UHELP to INFO Conversion in the CLSC Library on
  6. 20-Jan-87 18:00:01
  7. 
  8. File: DVI.INFO, Node: Top, Up: (CLSC)
  9.  
  10.        DVIxxx - Display TeX DVI Files on Assorted Output Devices
  11.                               [26-Dec-86]
  12.  
  13. * Menu:
  14.  
  15. * SYNOPSIS::
  16. * SAMPLE-EXECUTION::
  17. * DESCRIPTION::
  18. * SCREEN-CONTROL::
  19. * SPECIALS::
  20. * ENVIRONMENT-VARIABLES::
  21. * IBM-PC-Caveats::
  22. * FILES::
  23. * SEE-ALSO::
  24. * BUGS::
  25. * AUTHORS::
  26.  
  27. 
  28. File Name: DVI.INFO, Node: SYNOPSIS, Up: Top, Next: SAMPLE-EXECUTION
  29.  
  30. SYNOPSIS
  31.  Several TeX DVI translators are available.  They all expect  the
  32.  name of the  .DVI file on  the command line,  and the  extension
  33.  .DVI can  always be  omitted.  As  illustrated below  (extracted
  34.  from a PHOTO log), they issue a one-line identifier message and,
  35.  if no  command  line  arguments are  given,  type  a  Unix-style
  36.  ``usage'' message.  Some of them may have additional help  files
  37.  (*note: SEE ALSO. section below).
  38.  
  39.  On case-sensitive file systems, file names may be expected to be
  40.  entirely in lower  case, so  you should  should type  ``dvialw''
  41.  instead of ``DVIALW''.
  42.  
  43.  For  all  except  DVIBIT  (which  is  intended  for  interactive
  44.  display), the output  file will be  given the name  of the  .DVI
  45.  file, but extension .DVI-xxx,  where xxx is the  three-character
  46.  mnemonic for the translator program.   For DVIBIT, output is  on
  47.  ``stdout'' which defaults to the terminal; it may be  redirected
  48.  in the usual Unix fashion  by ``>filename'' on the command  line
  49.  (e.g.  @DVIBIT foo >foo.out).
  50.  
  51.  As the .DVI file  is processed, a list  of errors is printed  on
  52.  the standard error unit ``stderr'', this list is also saved in a
  53.  file with extension .DVI-LOG.  This file is not created if there
  54.  are no  errors.  As  each  page is  printed, the  physical  page
  55.  number and the TeX  page number is  printed without a  following
  56.  character return; after the last  page, the string `` [OK]''  is
  57.  printed, followed by a carriage return.  This gives a convenient
  58.  progress report to the terminal.  If it is not wanted, then  the
  59.  error output can be  redirected into a  file (possibly the  null
  60.  device) (e.g. @DVIxxx foo &foo.err), or the ``-q'' option can be
  61.  given to suppress it.
  62.  
  63.  The  order  of  command  options  and  DVI  file  names  is  not
  64.  significant; all  switch values  apply to  all DVI  files.   DVI
  65.  files are processed in order from left to right.
  66.  
  67.  The available translators are as follows:
  68.  
  69.         DVIALW          PostScript (Apple LaserWriter)
  70.         DVIDOC          Very rough printer image of a DVI file
  71.         DVIBIT          Version 3.10 BBN BitGraph terminal
  72.         DVIGD           Golden Dawn Golden Laser 100 printer
  73.         DVIIMP          Imagen imPRESS-language laser printer
  74.                         family 
  75.         DVIJET          Hewlett-Packard Laser Jet
  76.         DVIJEP          Hewlett-Packard Laser Jet Plus
  77.         DVIM72          Apple Imagewriter 72 dpi printer
  78.         DVIMAC          Apple Imagewriter 144 dpi printer
  79.         DVIMPI          MPI Sprinter 72 dpi printer
  80.         DVIO72          OKIDATA Pacemark 2410 72 dpi printer
  81.         DVIOKI          OKIDATA Pacemark 2410 144 dpi printer
  82.         DVIPRX          Printronix 60h x 72v dpi printer
  83.         DVITOS          Toshiba P-1351 180 dpi printer
  84.         DVITYP or DVITYPE  DVI Translator for human-readable output
  85.  
  86. 
  87. File Name: DVI.INFO, Node: SAMPLE-EXECUTION, Previous: SYNOPSIS, Up: Top, Next: DESCRIPTION
  88.  
  89. SAMPLE-EXECUTION
  90.  A sample execution of LATEX and DVIALW from a PHOTO log is as follows:
  91.  
  92.       @latex biblio.ltx
  93.       This is TeX, Tops-20 Version 1.1 (preloaded format=lplain 84.9.29)
  94.       (APS:<BEEBE.PLOT79.DOCUMENTATION>BIBLIO.LTX.28
  95.       LaTeX Version 2.06a - Release 7 July 84
  96.       (APS:<TEX.LATEX>REPORT.STY.2
  97.       Document Style 'report'. Version 0.91 - released 25 June 1984
  98.       (APS:<TEX.LATEX>REP11.STY.2))
  99.       (APS:<BEEBE.PLOT79.DOCUMENTATION>MYBIBLIO.STY.1 Mybibliography
  100.       environment style - Version 0.0 - 15-May-86)
  101.       (APS:<BEEBE.PLOT79.DOCUMENTATION>BIBLIO.AUX.12) [0]
  102.       (APS:<BEEBE.PLOT79.DOCUMENTATION>BIBLIO1.LTX.3 [1] [2] [3] [4] [5]) [6]
  103.       (APS:<BEEBE.PLOT79.DOCUMENTATION>BIBLIO.AUX.13)
  104.       (see the transcript file for additional information)
  105.       Output written on APS:<BEEBE.PLOT79.DOCUMENTATION>BIBLIO.DVI.1 (7
  106.       pages, 13960 bytes).
  107.       Transcript written on APS:<BEEBE.PLOT79.DOCUMENTATION>BIBLIO.LST.1.
  108.  
  109.       @dvialw -x0.3in -y0.2in biblio bt:example
  110.       [TeX82 DVI Translator Version 2.0 for PostScript [Apple LaserWriter
  111.       laser printer]]
  112.       [Input from DVI file biblio.dvi]
  113.       [Output on file biblio.dvi-alw]
  114.       [7 pages]
  115.       [1500 magnification]
  116.       [7{6}] [6{5}] [5{4}] [4{3}] [3{2}] [2{1}] [1{0}]  [OK]
  117.       [Input from DVI file bt:example.dvi]
  118.       [Output on file bt:example.dvi-alw]
  119.       [1 pages]
  120.       [1500 magnification]
  121.       [1{1}]  [OK]
  122.  
  123.  When the TOPS-20 version of TeX finishes execution, it  normally
  124.  simulates terminal input of a line of the form
  125.  
  126.  TeXspool: dvifile
  127.  
  128.  without supplying a final carriage return.  The default value of
  129.  the logical name TeXspool: points to a dummy program which  does
  130.  nothing, so if  you just  type a carriage  return yourself,  the
  131.  line is  effectively ignored.   This is  reasonable in  that  it
  132.  usually takes  several  trips  through TeX  before  you  have  a
  133.  ``.dvi'' file worth  printing.  If  you like,  you can  redefine
  134.  ``TeXspool:'' to  point to  your  favorite DVI  translator,  for
  135.  example,
  136.  
  137.  define TeXspool: sys:dvialw.exe
  138.  
  139.  Then when you type a carriage return when TeX finishes, it  will
  140.  run the translator immediately, saving you a line of typing.  If
  141.  you do not want the translator  to run, just cancel the line  by
  142.  typing CTL-U or CTL-C.
  143.  
  144.  A sample invocation of DVITYPE is as follows:
  145.  
  146.       @dvitype
  147.       DVIFILE   : dvifile
  148.       OUTPUT    : tty:
  149.       This is DVItype, Tops-20 Version 2.6
  150.       Output level (default=3, ? for help):
  151.       Starting page (default=*):
  152.       Maximum number of pages (default=1000000):
  153.       Assumed device resolution in pixels per inch (default=240/1):
  154.       New magnification (default=0 to keep the old one):
  155.       Options selected:
  156.         Starting page = *
  157.         Maximum number of pages = 1000000
  158.         Output level = 3 (the works)
  159.         Resolution =  240.00000000 pixels per inch
  160.       numerator/denominator=25400000/473628672
  161.       magnification=1000;       0.00005067 pixels per DVI unit
  162.       ' TeX output 1984.09.29:2210'
  163.       Postamble starts at byte 23408.
  164.       maxv=40763392, maxh=26738688, maxstackdepth=9, totalpages=9
  165.       Font 73: amcsc10---loaded at size 655360 DVI units
  166.       Font 72: amcsc10---loaded at size 1132462 DVI units
  167.       (this font is magnified 173%)
  168.       ...and so on...
  169.  
  170.  
  171. 
  172. File Name: DVI.INFO, Node: DESCRIPTION, Previous: SAMPLE-EXECUTION, Up: Top, Next: SCREEN-CONTROL
  173.  
  174. DESCRIPTION
  175.  These  drivers  are  written  in  C,  and  with  C  preprocessor
  176.  conditional compilation  features,  are  all  derived  from  one
  177.  master set of files, so  that there is substantial code  sharing
  178.  among them.   Host machine  and output  device dependencies  are
  179.  parametrized to allow easy movement to new hosts and new  output
  180.  devices.    Implementations   now    exist   on   Gould    Unix,
  181.  Hewlett-Packard Unix, PC-DOS,  TOPS-20, VAX Unix,  and VAX  VMS,
  182.  with others in progress.
  183.  
  184.  The command options are (letter case is IGNORED):
  185.  
  186.         -a      Implement  virtual  font  caching,  if  possible.
  187.                 When a font file is opened, a buffer is allocated
  188.                 to contain the entire file, and the file is  then
  189.                 read with  one system  call.  This  is  important
  190.                 primarily on  networked file  systems, where  the
  191.                 many random-access  calls in  the font  file  for
  192.                 small amounts of data entail substantial  network
  193.                 overhead.  With the entire  file cached in  local
  194.                 memory, this overhead is removed.  The additional
  195.                 memory required for the font file buffers amounts
  196.                 to 100K to 200K  bytes (assuming the compact  .PK
  197.                 font file format),  which is  not excessive.   If
  198.                 memory cannot be allocated for a font file,  then
  199.                 normal buffering  of  small blocks  is  used.   A
  200.                 trace option (-d64)  is provided  to monitor  the
  201.                 font caching; see below.
  202.  
  203.         -b      Backwards order printing  from the default.   For
  204.                 example, laser  printers using  the Canon  engine
  205.                 print normally  receive  pages in  reverse  order
  206.                 because they stack  printed side  up.  Some  have
  207.                 page handling  mechanisms  that stack  them  face
  208.                 down, and in such a case -b will ensure that they
  209.                 come   out   in   order   1,2,...   instead    of
  210.                 n,n-1,n-2,...
  211.  
  212.         -c#     Print # copies of each output page.  Page  copies
  213.                 are printed  consecutively;  this does  NOT  give
  214.                 multiple collated copies of the entire job.
  215.  
  216.         -d#     Produce  debugging  output  on  ``stderr''  if  a
  217.                 non-zero value is  given.  Only  the last  switch
  218.                 given is  used.   Add  values  of  the  following
  219.                 possible options to obtain the switch value:
  220.  
  221.                 1       (DVIJET only) print page bitmap in
  222.                         hexadecimal;
  223.  
  224.                 2       display page coordinates  and metrics  of
  225.                         each output  character,  and  print  each
  226.                         character bitmap in hexadecimal;
  227.  
  228.                 4       (DVIJEP  only)   display   updated   page
  229.                         coordinate of each  character after  each
  230.                         call to ``fixpos()'';
  231.  
  232.                 8       print filename  and  open  mode  of  each
  233.                         SUCCESSFUL file opening;
  234.  
  235.                 16      print filename  and  open  mode  of  each
  236.                         UNSUCCESSFUL file opening;
  237.  
  238.                 32      show discarded off-page text;
  239.  
  240.                 64      trace virtual font caching.
  241.  
  242.                 For example, -d24 will trace all attempted
  243.                 file openings.
  244.  
  245.    -eVAR=value
  246.                 Define an  environment  variable on  the  command
  247.                 line   (see   the   later   section   ENVIRONMENT
  248.                 VARIABLES).  The  acceptable values  for VAR  are
  249.                 DVIHELP,  FONTLIST,   TEXFONTS,  and   TEXINPUTS.
  250.                 Under normal use of the Translators, these can be
  251.                 set by TOPS-20 and VAX VMS ``define VAR:  value''
  252.                 commands, or by Unix ``csh'' ``setenv VAR=value''
  253.                 or  ``sh''  ``VAR=value''  commands.   When   the
  254.                 translator is invoked by another program, such as
  255.                 a print spooler,  on some systems  it may not  be
  256.                 possible  to  set  a  particularly  value  of  an
  257.                 environment variable for the subprocess, so  this
  258.                 option gets around this limitation.  On most Unix
  259.                 systems, it should  be possible to  use the  call
  260.                 ``system("VAR=value; dvixxx filename")''.
  261.  
  262.         -ffontsubfile
  263.                 Define an alternate font substitution file  which
  264.                 is to be  used instead of  the default ones  (see
  265.                 below).
  266.  
  267.         -l      Inhibit logging.
  268.  
  269.         -m#
  270.                 Reset magnification to #.       The  default  for
  271.                 low
  272.                 resolution printers is ``-m579'',       corresponding   to
  273.                 (1/1.2**3) magnification.       By            TeX
  274.                 conventions, magnification 1000 corresponds to  a
  275.                 200-dot/inch   output   device.    The    default
  276.                 magnification is always adjusted according to the
  277.                 output device  resolution  in  order  to  give  a
  278.                 normal page size, so this parameter should rarely
  279.                 be required.  Legal values are int((1000 or  1440
  280.                 or 1500)*(1.2)**(k/2)) (k = -16,16); other values
  281.                 will be set to the  nearest in this family.   Not
  282.                 all fonts will be  available in this wide  range,
  283.                 and most installations will probably have only  a
  284.                 half dozen or so magnifications.
  285.  
  286.         -o# and -o#:# and -o#:#:#
  287.                 Specify a page number, or range of page  numbers,
  288.                 to be selected  for output.  In  the third  form,
  289.                 the last number is the page number step size;  it
  290.                 is normally 1.  This option may be specified  any
  291.                 number of times.   If it is  not specified,  then
  292.                 all pages will be printed.  Pages are numbered in
  293.                 order 1,2,3,...  in the file, but any page number
  294.                 recorded by  TeX  on  the printed  page  will  in
  295.                 general be different.
  296.  
  297.                 Negative page numbers count  backward; -1 is  the
  298.                 last page  in the  document, -2  the second  last
  299.                 page, and so on.
  300.  
  301.                 As pages  are  selected for  printing,  ``[#{#}''
  302.                 will be printed on ``stderr'', where the first is
  303.                 the page number  in the file,  and the second  is
  304.                 the value  of  the TeX  counter,  \count0,  which
  305.                 usually records  the printed  page number.   When
  306.                 the page is  completely output,  a closing  ``]''
  307.                 will  be  printed   on  ``stderr''.   Any   error
  308.                 messages  from  processing  of  that  page   will
  309.                 therefore occur between the square brackets.  For
  310.                 example, ``-o1:3  -o12  -o17:23  -o-3:-1''  would
  311.                 select pages 1, 2, 3, 12, 17, 18, 19, 20, 21, 22,
  312.                 and 23, plus the last three pages.
  313.  
  314.                 Pages  will  always  be   printed  in  an   order
  315.                 appropriate for  the  device so  that  the  first
  316.                 document  page  occurs  first  face  up  in   the
  317.                 document stack; the ``-b'' option can be used  to
  318.                 reverse   this   order.    For   example,    some
  319.                 Hewlett-Packard  Laser  Jet  Plus  printers   are
  320.                 equipped with a page flipper which stacks  output
  321.                 face down;  for  these, the  ``-b''  option  will
  322.                 ensure that the  pages come out  in the  expected
  323.                 order.
  324.  
  325.                 Specification of  a  page  number  step  size  is
  326.                 useful for producing duplex (two-sided) printing.
  327.                 For example, with laser printers using the  Canon
  328.                 LBP-CX  engine,  the  first  run  could   specify
  329.                 ``-o1:9999:2'', which would stack output face up,
  330.                 beginning with  the last  page, and  ending  with
  331.                 page 1 on  top.  The  printed pages  can then  be
  332.                 reinserted in the input tray  FACE UP, page 1  on
  333.                 the top, exactly as they were found in the output
  334.                 tray, with  the  top  of the  page  in  the  tray
  335.                 closest to the end  which is inserted first  into
  336.                 the printer.  A second run with ``-b -o2:9999:2''
  337.                 would then print pages 2, 4, ..., on the backs of
  338.                 pages 1, 3,  ...; note the  ``-b'' option to  get
  339.                 backwards order on the second run.
  340.  
  341.                 There is a bug  in Microsoft C's ``sscanf()''  on
  342.                 the IBM PC; it does not correctly parse input  on
  343.                 the format  "%d:%d:%d"  in ``option()''  for  the
  344.                 page number  switch.   It correctly  returns  the
  345.                 numbers, but instead of  returning the number  of
  346.                 such items parsed,  it returns  -1, which  should
  347.                 only happen if  none are parsed.   A work  around
  348.                 seems to be  to supply  a trailing  colon on  the
  349.                 switch, so that  you write  ``-o17:'' instead  of
  350.                 ``-o17''.
  351.  
  352.         -p      Inhibit font preloading.  This may produce output
  353.                 a few seconds earlier when all pages are  output,
  354.                 but  should   have  negligible   effect  on   the
  355.                 execution time, and consequently, should normally
  356.                 not be  specified.   When  individual  pages  are
  357.                 being printed with the -o# option, preloading  is
  358.                 necessary (and will be forced) to ensure that all
  359.                 fonts are defined before they are referenced.
  360.  
  361.         -q      Quiet mode.   Status displays  to ``stderr''  are
  362.                 suppressed, unless warning or error messages  are
  363.                 issued.
  364.  
  365.         -r#     (Device = HP Laser Jet only).  Specify the  Laser
  366.                 Jet output resolution  in dots  per inch.   ``#''
  367.                 must be one of 75, 100, 150, or 300.  The  actual
  368.                 plot file  is identical  in each  case; only  the
  369.                 size on the output  page is changed, because  the
  370.                 resolution change is effected by printing 1 x  1,
  371.                 2 x 2, 3 x 3, or 4 x 4 pixel blocks.
  372.  
  373.         -r      (Device  =  Golden   Laser  100  only).    Select
  374.                 run-length encoding  of  the output  file.   This
  375.                 reduces disk space typically  by 10% to 40%,  but
  376.                 increases host CPU  time for  the preparation  of
  377.                 the output file.
  378.  
  379.         -r      (Device  =  Apple   ImageWriter  only).    Select
  380.                 run-length encoding of the output file.
  381.  
  382.         -r      (Device   =   Toshiba   P-1351   only).    Select
  383.                 run-length encoding  of  the output  file.   This
  384.                 reduces disk space typically  by 10% to 40%,  but
  385.                 increases host CPU  time for  the preparation  of
  386.                 the output file, and because of poor logic in the
  387.                 printer, may double  the print  time!  The  print
  388.                 quality is  also  substantially  worse,  so  this
  389.                 option is generally NOT recommended.
  390.  
  391.         -s#     (Device  =   Apple  LaserWriter   only).    Force
  392.                 characters larger than #  pixels wide or high  to
  393.                 be reloaded  each time  they are  required.   The
  394.                 Version 23.0  PostScript  interpreter has  a  bug
  395.                 which manifests  itself  in  fatal  ``VM  error''
  396.                 messages  when  large  characters  are  sent.   A
  397.                 reasonable default value  has been  set for  this
  398.                 which  should   normally   avoid   the   problem.
  399.                 Specifying ``-s0'' will cause reloading of  every
  400.                 character each time it is used.
  401.  
  402.         -v      (Device  =   Apple  LaserWriter   only).    Force
  403.                 reloading of all required fonts at start of  each
  404.                 page.
  405.  
  406.         -x#bp   big point (1in = 72bp)
  407.         -x#cc   cicero (1cc = 12dd)
  408.         -x#cm   centimeter
  409.         -x#dd   didot point (1157dd = 1238pt)
  410.         -x#in   inch
  411.         -x#mm   millimeter (10mm = 1cm)
  412.         -x#pc   pica (1pc = 12pt)
  413.         -x#pt   point (72.27pt = 1in)
  414.         -x#sp   scaled point (65536sp = 1pt)
  415.                 The ``-x'' options specify the left margin of the
  416.                 TeX page  on  the  output  page  in  any  of  the
  417.                 indicated units.  Letter case is not  significant
  418.                 in the unit  field, which must  not be  separated
  419.                 from  the  number  by   any  space.   #  may   be
  420.                 fractional.     For     example,     ``-x1.0in'',
  421.                 ``-x2.54cm'', ``-x72.27pt'',  and  ``-x6.0225pc''
  422.                 all specify  a one  inch left  margin.   Negative
  423.                 values are permissible, and may be used to  shift
  424.                 the output page left  (possibly truncating it  on
  425.                 the left) in order to display a wide TeX page.
  426.  
  427.         -y#     inch
  428.         -y#bp   big point (1in = 72bp)
  429.         -y#cc   cicero (1cc = 12dd)
  430.         -y#cm   centimeter
  431.         -y#dd   didot point (1157dd = 1238pt)
  432.         -y#in   inch
  433.         -y#mm   millimeter (10mm = 1cm)
  434.         -y#pc   pica (1pc = 12pt)
  435.         -y#pt   point (72.27pt = 1in)
  436.         -y#sp   scaled point (65536sp = 1pt)
  437.                 The ``-y'' options specify the top margin of  the
  438.                 TeX page  on  the  output  page  in  any  of  the
  439.                 indicated units.  Letter case is not  significant
  440.                 in the unit  field, which must  not be  separated
  441.                 from  the  number  by   any  space.   #  may   be
  442.                 fractional.     For     example,     ``-y1.0in'',
  443.                 ``-y2.54cm'', ``-y72.27pt'',  and  ``-y6.0225pc''
  444.                 all specify  a  one inch  top  margin.   Negative
  445.                 values are permissible, and may be used to  shift
  446.                 the output page up (possibly truncating it on the
  447.                 top) in order to display a long TeX page.
  448.  
  449.    -z
  450.                 (Device = Apple LaserWriter  or HP LaserJet  Plus
  451.                 on TOPS-20 only).  For  each DVI file  processed,
  452.                 type in an EXEC command ``DVISPOOL: dvifilename''
  453.                 followed by a newline;  the user may then  define
  454.                 DVISPOOL:  to  be  a  program  which  sends   the
  455.                 translation of the  DVI file  to the  appropriate
  456.                 output spooler.
  457.  
  458.  If no ``-ffontsubfile'' option  is given, and font  substitution
  459.  is required, if the current DVI file is foo.dvi, then the  files
  460.  ``foo.sub'',  ``texfonts.sub'',  and  ``texinputs:texfonts.sub''
  461.  will be tried  in order.   The first two  will be  found on  the
  462.  current directory, and  the last  is the  system default.   This
  463.  gives  the  option  of  document-specific,  user-specific,   and
  464.  system-specific substitutions, and the ``-f'' option allows  all
  465.  of these to be overridden.
  466.  
  467.  
  468.  Font substitution lines have the form:
  469.  
  470.  % comment
  471.  oldname.oldmag  ->     subname.submag  % comment
  472.  oldname oldmag  ->     subname submag  % comment
  473.  oldname         ->     subname         % comment
  474.  
  475.  Examples are:
  476.  
  477.  % These provide replacements for some LaTeX invisible fonts:
  478.  iamr10 1500    ->      amr10 1500      % comment
  479.  iamr10.1500    ->      amr10.1500      % comment
  480.  iamssb8        ->      amssb8          % comment
  481.  
  482.  The first two  forms request substitution  of a particular  font
  483.  and magnification.  The  third form substitutes  an entire  font
  484.  family; the closest available magnification to the required  one
  485.  will be  used.  Any  dots  in the  non-comment portion  will  be
  486.  converted to spaces,  and therefore,  cannot be part  of a  name
  487.  field.
  488.  
  489.  The  first   matching   substitution  will   be   selected,   so
  490.  magnification-specific  substitutions  should  be  given  first,
  491.  before family substitutions.
  492.  
  493.  Comments are introduced by percent and continue to  end-of-line,
  494.  just as for TeX.  One whitespace character is equivalent to  any
  495.  amount of whitespace.  Whitespace and comments are optional.
  496. 
  497. File Name: DVI.INFO, Node: SCREEN-CONTROL, Previous: DESCRIPTION, Up: Top, Next: SPECIALS
  498.  
  499. SCREEN-CONTROL
  500.  
  501.  At present,  DVIBIT is  the only  family member  which  supports
  502.  interactive  viewing   of  the   TeX  output.    The   following
  503.  description therefore applies only to it, but the  functionality
  504.  should be adhered to in any new interactive device drivers.
  505.  
  506.  All switches, including the page selection (-o) and page  origin
  507.  (-x and  -y)  switches,  work normally.   When  the  end-of-page
  508.  command is reached in the DVI  file, the driver will display  at
  509.  the top of the screen a two-line message containing a help  menu
  510.  and the current  page numbers  in the document,  then pause  for
  511.  terminal input.  Any typeahead  is flushed before reading  input
  512.  to make sure the user is synchronized with the display, and  any
  513.  illegal input is discarded with  a warning beep.  The input  can
  514.  select
  515.  
  516.     *    redisplay of the current page, possibly shifting it  up,
  517.          down, left, or right, to see more of it, or to restore a
  518.          display trashed  by  an  unexpected  system  message  or
  519.          transmission line error;
  520.  
  521.     *    continuation to the next page in the page list  selected
  522.          by default or by the -o option;
  523.  
  524.     *    backing  up  to  the   previous  page  (useful  if   you
  525.          overshoot);
  526.  
  527.     *    display of  an arbitrary  page  by typing  its  sequence
  528.          number;
  529.  
  530.     *    termination of execution.
  531.  
  532.  Although the menu bar on the top line displays only a subset  of
  533.  the possible commands,  a number  of synonyms  are provided  for
  534.  user convenience.  In particular, arrow  keys in VT52 and  VT100
  535.  modes are recognized, as are EMACS control-character commands to
  536.  move the cursor or page display.
  537.  
  538.  The display  shifts by  a  quarter of  its  height or  width  in
  539.  response to an up, down, left, or right movement command.
  540.  
  541.  Here is the current  command list.  For single-letter  commands,
  542.  letter-case is not significant.  In most implementations,  input
  543.  is immediate;  no  terminating  carriage  return  is  necessary.
  544.  Consequently, typing error correction is supported only for  the
  545.  digit string command.
  546.  
  547.     arrow keys
  548.         Move the display up, down, left, or right.
  549.  
  550.     D or CTL-N
  551.         Move the display down.
  552.  
  553.     U or CTL-P
  554.         Move the display up.
  555.  
  556.     L or CTL-B
  557.         Move the display left.
  558.  
  559.     R or CTL-F
  560.         Move the display right.
  561.  
  562.     . or CTL-L
  563.         Redisplay current page.
  564.  
  565.     CARET or BACKSPACE
  566.         Redisplay previous page.
  567.  
  568.     nnn
  569.         nnn is a digit  string; DELETE/RUBOUT and BACKSPACE  keys
  570.         correct typing errors in it.  Move to nnn-th page,  where
  571.         document pages  are numbered  1, 2,  ....  The  TeX  page
  572.         numbers are  displayed  under the  menu  bar. This  is  a
  573.         recursive display; if you  respond at end-of-page with  a
  574.         next-page  command,  display  will  revert  to  the  page
  575.         sequence you were viewing when  you first issued the  nnn
  576.         command.
  577.  
  578.     SPACE or RETURN or CTL-V
  579.         Display next page.
  580.  
  581.     Q or X
  582.         Quit or exit.  The screen will be cleared and the terminal
  583.         restored to its normal font and emulation mode.
  584.  
  585.  
  586.  
  587. 
  588. File Name: DVI.INFO, Node: SPECIALS, Previous: SCREEN-CONTROL, Up: Top, Next: ENVIRONMENT-VARIABLES
  589.  
  590. SPECIALS
  591.  The TeX \special command is intended to allow the  specification
  592.  in a ``.TEX'' file of a  request to the DVI driver, usually  for
  593.  the insertion  of  graphical  material  at  that  point  in  the
  594.  document.  It is  currently implemented only  for DVIALW;  other
  595.  drivers will simply issue a warning message.
  596.  
  597.  The TeX \special command is expected to look like
  598.  
  599.      \special{overlay filename} % absolute positioning
  600.  or
  601.      \special{include filename} % relative positioning
  602.  or
  603.      \special{insert filename}  % relative positioning
  604.  
  605.  In the first case,  the PostScript file to  be included will  be
  606.  mapped onto the page at precisely the coordinates it  specifies.
  607.  In the other two  cases, the upper-left  corner of the  bounding
  608.  box will be placed  at the current  point.  The PostScript  file
  609.  must then contain (usually near the start) a comment of the form
  610.  
  611.  %%BoundingBox: llx lly urx ury
  612.  
  613.  specifying  the   bounding   box  lower-left   and   upper-right
  614.  coordinates  in   standard   PostScript   units   (1/72   inch).
  615.  Alternatively, if the comment
  616.  
  617.  %%BoundingBox: (atend)
  618.  
  619.  is found in the file, the last 1000 characters of the file  will
  620.  be searched to find a comment of the form:
  621.  
  622.  %%BoundingBox: llx lly urx ury
  623.  
  624.  If the PostScript file cannot be opened, or the \special command
  625.  string cannot be  recognized, or for  relative positioning,  the
  626.  bounding box cannot be determined,  a warning message is  issued
  627.  and the \special command is ignored.
  628.  
  629.  Otherwise, the  section  of  the  PostScript  file  between  the
  630.  comment lines
  631.  
  632.  %begin(plot)
  633.  %end(plot)
  634.  
  635.  is copied to the output file surrounded by
  636.  
  637.  save
  638.  300 72 div 300 72 div scale % revert to standard 1/72 inch units
  639.  (xcp(in 1/72in)-llx) (ycp(in 1/72in)-ury) translate  % if relative positioning
  640.  ...PostScript file contents...
  641.  restore
  642.  
  643.  Plot files produced by <PLOT79>  have all the expected  commands
  644.  in them to allow  their use in TeX  \special commands.  The  two
  645.  <PLOT79> parameters which influence the size of the plot are
  646.  
  647.         * the device size  specified in the  call to SETSZ();  it
  648.           defaults to 11in if SETSZ is not called.
  649.  
  650.         * the device space specified in  the call to SETDS2()  or
  651.           SETDS3(); it defaults  in the CORE  system to the  unit
  652.           square,  but  if  the  <PLOT79>  framing  routines  are
  653.           called,  they  will  reset   the  device  space  to   a
  654.           horizontal or  vertical  frame in  proportions  of  the
  655.           local standard paper size ($1 : 8.5/11$ in the USA).
  656.  
  657.  For example, if a device size of 5in is specified for a standard
  658.  horizontal frame, the bounding  box will be  declared to be  5in
  659.  wide and  (8.5/11.0)*5  = 3.8636in  high,  so a  TeX  manuscript
  660.  requiring the  plot could  have the  following commands  at  the
  661.  start of a new paragraph:
  662.  
  663.  \special{include plotfilename}
  664.  \vspace*{3.9in}
  665.  
  666. 
  667. File Name: DVI.INFO, Node: ENVIRONMENT-VARIABLES, Previous: SPECIALS, Up: Top, Next: IBM-PC-Caveats
  668.  
  669. ENVIRONMENT-VARIABLES
  670.  The behavior  of  the  DVI  translators  can  be  influenced  by
  671.  definition  of  logical  names  on  TOPS-20  and  VAX  VMS,   or
  672.  environment variables in UNIX and PC-DOS.  Compiled-in  internal
  673.  defaults will  be  provided  for  any of  these  which  are  not
  674.  defined.  The names currently recognized are as follows:
  675.  
  676.  DVIHELP        This variable  defines an  alternate help  string
  677.                 which is  typed  when  the user  makes  an  input
  678.                 error.  It should direct  the user to  additional
  679.                 documentation.  For  example, it  might be  ``try
  680.                 HELP DVI or XINFO DVI''.
  681.  
  682.  FONTLIST       Normally, the  drivers  are  prepared  to  search
  683.                 first for .PK,  then .GF, then  .PXL font  files.
  684.                 This variable can be  used to change this  search
  685.                 order,   or   remove   one   or   more   of   the
  686.                 possibilities.  It  is  expected  to  contain  at
  687.                 least one of the strings PK, GF, or PXL, possibly
  688.                 separated  by  arbitrary  punctuation  and  other
  689.                 text.   For   example,   ``PXL-then-PK-then-GF'',
  690.                 ``PK-GF'', ``PXL'', ``PXL/GF/PK''.
  691.  
  692.  TERM           This variable is used only for DVIBIT; if it does
  693.                 not evaluate  to either  ``bitgraph'' or  ``bg'',
  694.                 DVIBIT will refuse to run.  On Unix, this is  the
  695.                 conventional way of defining terminal types  with
  696.                 the TERMCAP or TERMINFO systems.
  697.  
  698.  TEXFONTS       This defines the directory path for finding  font
  699.                 files.  Its value is prepended  to the name of  a
  700.                 TeX font to get  a full file specification.   For
  701.                 example ``cmr10'' on a 300-dot/inch device  might
  702.                 correspond    on    TOPS-20    to    the    files
  703.                 ``texfonts:cmr10.300gf'',
  704.                 ``texfonts:cmr10.300pk'', or
  705.                 ``texfonts:cmr10.300pxl''.
  706.  
  707.  TEXINPUTS      This defines the directory path for finding files
  708.                 which are not in  the current working  directory.
  709.                 It is PREPENDED to file names.
  710.  
  711. 
  712. File Name: DVI.INFO, Node: IBM-PC-Caveats, Previous: ENVIRONMENT-VARIABLES, Up: Top, Next: FILES
  713.  
  714. IBM-PC-Caveats
  715.  The latest  version  of  the  drivers  has  been  compiled  with
  716.  Microsoft C Version 4.0.  With Version 3.0, some ``.dvi''  files
  717.  experienced a fatal ``floating-point stack overflow'' error both
  718.  with and without a floating-point coprocessor; this can only  be
  719.  due to code generation errors,  and it disappeared with  Version
  720.  4.0.
  721.  
  722.  PC-DOS by  default has  only a  small number  of available  open
  723.  files, and this number is not adequate for the drivers with  the
  724.  value of five for ``MAXOPEN''  set in ``machdefs.h''.  You  need
  725.  to increase the limits by entering the lines
  726.  
  727.  FILES=10
  728.  BUFFERS=10
  729.  
  730.  in the ``config.sys''  file in the  boot directory, then  reboot
  731.  the system to have  the new values  take effect.  Larger  values
  732.  are of course  possible, though ``FILES=20''  is the limit  with
  733.  current versions of PC-DOS.   Run-time performance can be  quite
  734.  sensitive to these settings, so you may wish to experiment.
  735.  
  736.  If there is no ``config.sys'' file, or the settings of ``FILES''
  737.  and ``BUFFERS'' are too small,  you will find the disk  whirring
  738.  madly  while  the  driver  attempts  to  open  font  files  with
  739.  neighboring magnifications, and then it will finally die with  a
  740.  message ``unable  to  open .err  file''.   Use of  the  ``-d24''
  741.  option may be useful in tracking how many files can successfully
  742.  be opened (that is why I added that switch option).
  743.  
  744.  The  drivers  have  been  loaded  with  the  default   Microsoft
  745.  floating-point library; the compiler generates calls to  library
  746.  routines which test  a flag  initialized at  startup time  which
  747.  indicates  the  presence  or   absence  of  the   floating-point
  748.  coprocessor chip.  If it is available, the library routines will
  749.  automatically use it.  You can force  the chip to be ignored  by
  750.  defining an arbitrary non-empty string value for the environment
  751.  variable ``NO87'', for example
  752.  
  753.  set NO87=no-8087-available
  754.  
  755.  When the DVI translator runs, the value of this variable  should
  756.  be typed on the screen as  the first output line.  On a  Leading
  757.  Edge PC, this typeout does not appear, for unknown reasons.   On
  758.  my 4.77MHz PC XT, the translators  run twice (!) as slowly  when
  759.  ``NO87'' is defined.
  760.  
  761.  The reason that you might need  to know this is that the  method
  762.  employed by the library routines  for detecting the presence  or
  763.  absence of an 8087 (or 80287) chip is not infallible, thanks  to
  764.  design flaws of some PC's and possibly also the Intel chips.  It
  765.  is conceivable that the library  might think a coprocessor  chip
  766.  is present, when in fact it is not, and the first floating-point
  767.  instruction executed would hang the machine.
  768.  
  769. 
  770. File Name: DVI.INFO, Node: FILES, Previous: IBM-PC-Caveats, Up: Top, Next: SEE-ALSO
  771.  
  772. FILES
  773.  *.dvi                  TeX DeVice Independent output file
  774.  
  775.  *.dvi-log              TeX DVIxxx translator error log
  776.  
  777.  *.err                  TeX DVIxxx translator error log when long
  778.                         extensions are not available
  779.  
  780.  *.dvi-xxx              TeX   device-dependent   DVI   translator
  781.                         output file
  782.  
  783.  *.xxx                  TeX DVIxxx  translator output  file  when
  784.                         long extensions are not available
  785.  
  786.  *.sub                  DVI file-specific font substitution file
  787.  
  788.  DVISPOOL:              Logical  name  (TOPS-20  only)   defining
  789.                         program which  sends translation  of  DVI
  790.                         file to the appropriate output spooler.
  791.  
  792.  texfonts.sub           Job-wide font substitution file
  793.  
  794.  texfonts:*.*pxl        TeX default font rasters
  795.  
  796.  texfonts:*.*gf         TeX default font rasters
  797.  
  798.  texfonts:*.*pk         TeX default font rasters
  799.  
  800.  texinputs:dvialw.ps    PostScript   header    file    containing
  801.                         standard macro  definitions  prefixed  to
  802.                         PostScript output from DVIALW
  803.  
  804.  texinputs:texfonts.sub System-wide font substitution file
  805.  
  806. 
  807. File Name: DVI.INFO, Node: SEE-ALSO, Previous: FILES, Up: Top, Next: BUGS
  808.  
  809. SEE-ALSO
  810.  dvitype,  tex,  ``Local  LaTeX  Guide'',  ``A  TeX  DVI   Driver
  811.  Family''.
  812.  
  813. 
  814. File Name: DVI.INFO, Node: BUGS, Previous: SEE-ALSO, Up: Top, Next: AUTHORS
  815.  
  816. BUGS
  817.  None known.
  818.  
  819.  
  820. 
  821. File Name: DVI.INFO, Node: AUTHORS, Previous: BUGS, Up: Top, Next: 
  822.  
  823. AUTHORS
  824.  David Fuchs  at Stanford  University wrote  DVITYPE in  WEB  and
  825.  defined the DVI file format.
  826.  
  827.  Mark Senn at  Purdue University wrote  a preliminary version  of
  828.  the BBN BitGraph driver in C, using DVITYPE as a model.
  829.  
  830.  Stephan v. Bechtolsheim and Bob Brown at Purdue, Robert Wells at
  831.  BBN, and  Jim Schaad  and Richard  Furuta at  the University  of
  832.  Washington, improved it.
  833.  
  834.  The transformation to about a  dozen other device drivers,  plus
  835.  the massive code rearrangement for many new features as well  as
  836.  easy identification of host-  and device-dependent sections,  as
  837.  well as support for ``.pk'' and ``.gf'' compact font files,  was
  838.  carried out at the University of Utah by Nelson H.F.  Beebe.  He
  839.  also wrote the documents ``A TeX DVI Driver Family'' and ``Using
  840.  LaTeX  at the  University of Utah  College of Science  DEC-20''.
  841.  The first  describes all  of these  drivers in  detail, and  the
  842.  second is the ``Local LaTeX Guide''.
  843.  
  844.  Lon Willett at Utah adapted DVIJEP to make DVIIMP for the Imagen
  845.  laser printer family.
  846.  
  847.  Norman Naugle and colleagues at Texas A&M implemented the family
  848.  on several new systems.
  849.  
  850. 
  851. Tag Table:
  852. File: DVI.INFO, Node: Top283
  853. File Name: DVI.INFO, Node: SYNOPSIS644
  854. File Name: DVI.INFO, Node: SAMPLE-EXECUTION3629
  855. File Name: DVI.INFO, Node: DESCRIPTION7122
  856. File Name: DVI.INFO, Node: SCREEN-CONTROL23940
  857. File Name: DVI.INFO, Node: SPECIALS27235
  858. File Name: DVI.INFO, Node: ENVIRONMENT-VARIABLES30308
  859. File Name: DVI.INFO, Node: IBM-PC-Caveats32636
  860. File Name: DVI.INFO, Node: FILES35436
  861. File Name: DVI.INFO, Node: SEE-ALSO36752
  862. File Name: DVI.INFO, Node: BUGS36920
  863. File Name: DVI.INFO, Node: AUTHORS37030
  864. 
  865. End Tag Table
  866.