





























































     Page 1                                           (printed 5/6/92)






     TTTTeeeeXXXXssssggggiiii((((1111LLLL))))                 ((((JJJJuuuunnnneeee 1111999988889999))))                 TTTTeeeeXXXXssssggggiiii((((1111LLLL))))



     NNNNAAAAMMMMEEEE
          TeXsgi - TeX DVI previewer for the Silicon Graphics Iris


     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          tttteeeexxxxssssggggiiii [----dddd####] [----ffff_f_o_n_t_s_u_b_f_i_l_e] [----llll] [----mmmm####] [----qqqq]
          [----ssssFIStartupfile]]]] [[[[----xxxx####_u_n_i_t_s]]]] [[[[----yyyy####_u_n_i_t_s]]]] ddddvvvviiiiffffiiiilllleeee1111


     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          TeXsgi only runs on the workstation console and only on  the
          4D  series.   It  expects  the  name  of the DVI file on the
          command line, and the extension ._d_v_i can always be omitted.

          As the ._d_v_i file is processed, a list of errors  is  printed
          on  the standard error unit, _s_t_d_e_r_r; this list is also saved
          in a file with suffix ._d_v_i-_e_r_r This file is not  created  if
          there  are  no errors. The ----qqqq (quiet) option can be given to
          suppress error messages, as can the QQQQ runtime  command.   As
          each page is displayed, the physical page number and the TeX
          page number(s) are printed on a status line at the bottom of
          the screen.

          TeXsgi uses the 118 dpi and 300 dpi PPPPKKKK fonts.


     OOOOPPPPTTTTIIIIOOOONNNNSSSS
          The order of command  options  and  DVI  file  name  is  _n_o_t
          significant.

          Letter case is _i_g_n_o_r_e_d in option switches

          ----ffff_f_o_n_t_s_u_b_f_i_l_e
               Define an alternate font substitution file which is  to
               be used instead of the default ones (see below).

          ----llll   Inhibit logging.

          ----mmmm####  Reset magnification to #.  The default is ----mmmm555599990000.

          ----qqqq   Quiet mode.  Status displays to _s_t_d_e_r_r are  suppressed,
               unless  warning  or  error  messages are issued. A most
               useful option for the current version of the previewer.

          ----ssss_S_t_a_r_t_u_p_f_i_l_e
               Define an alternate startup file which is  to  be  used
               _a_f_t_e_r the default ones (see below).

          ----xxxx####_u_n_i_t_s
               The  ----xxxx options specify the left margin of the TeX page
               on  the  output  page  in  any  of the indicated units.
               Letter case is not  significant  in  the  units  field,



     Page 1                                           (printed 5/6/92)






     TTTTeeeeXXXXssssggggiiii((((1111LLLL))))                 ((((JJJJuuuunnnneeee 1111999988889999))))                 TTTTeeeeXXXXssssggggiiii((((1111LLLL))))



               which  must  _n_o_t  be  separated  from the number by any
               space. # may  be  fractional.   For  example,  ----xxxx1111....0000iiiinnnn,
               ----xxxx2222....55554444ccccmmmm,  ----xxxx77772222....22227777pppptttt, and ----xxxx6666....0000222222225555ppppcccc all specify a one-
               inch left margin. Negative values are permissible,  and
               may  be  used  to  shift the output page left (possibly
               truncating it on the left) in order to display  a  wide
               TeX page.

               The _u_n_i_t_s field is mandatory, and may be one of

               bbbbpppp   big point (1in = 72bp)

               cccccccc   cicero (1cc = 12dd)

               ccccmmmm   centimeter (1in = 2.54cm)

               dddddddd   didot point (1157dd = 1238pt)

               iiiinnnn   inch

               mmmmmmmm   millimeter (10mm = 1cm)

               ppppcccc   pica (1pc = 12pt)

               pppptttt   point (72.27pt = 1in)

               sssspppp   scaled point (65536sp = 1pt)

          ----yyyy####_u_n_i_t_s
               The ----yyyy options specify the top margin of the  TeX  page
               on  the output page.  Letter case is not significant in
               the units field, which must _n_o_t be separated  from  the
               number  by  any  space.   #  may  be  fractional.   For
               example, ----yyyy1111....0000iiiinnnn, ----yyyy2222....55554444ccccmmmm, ----yyyy77772222....22227777pppptttt,  and  ----yyyy6666....0000222222225555ppppcccc
               all specify a one-inch top margin.  Negative values are
               permissible, and may be used to shift the  output  page
               up  (possibly  truncating  it  on  the top) in order to
               display a long TeX page.

               By decree of the Stanford TeX Project, the default  TeX
               page  origin  is  always  1 inch over and down from the
               top-left page  corner,  even  when  non-American  paper
               sizes   are  used.   This  corresponds  to  the  switch
               settings ----xxxx1111iiiinnnn ----yyyy1111iiiinnnn; these values are  assumed  unless
               overridden.


     FFFFOOOONNNNTTTT SSSSUUUUBBBBSSSSTTTTIIIITTTTUUUUTTTTIIIIOOOONNNN
          If no ----ffff_f_o_n_t_s_u_b_f_i_l_e option is given, and  font  substitution
          is  required,  if  the current DVI file is _f_o_o._d_v_i, then the
          files _f_o_o._s_u_b, _t_e_x_f_o_n_t_s._s_u_b, and _t_e_x_i_n_p_u_t_s/_t_e_x_f_o_n_t_s._s_u_b will
          be  tried  in  order.   The  first  two will be found on the



     Page 2                                           (printed 5/6/92)






     TTTTeeeeXXXXssssggggiiii((((1111LLLL))))                 ((((JJJJuuuunnnneeee 1111999988889999))))                 TTTTeeeeXXXXssssggggiiii((((1111LLLL))))



          current directory, and the last is the system default.  This
          gives  the  option  of document-specific, user-specific, and
          system-specific substitutions, and the ----ffff option allows  all
          of these to be overridden.

          Font substitution lines have the form:

          % comment
          oldname.oldmag  ->  subname.submag  % comment
          oldname oldmag  ->  subname submag  % comment
          oldname         ->  subname         % comment

          The  first   two   forms   request    substitution    of   a
          particular    font   and  magnification.   The  third   form
          substitutes an  entire font family;  the  closest  available
          magnification  to the  required one will be used.   Any dots
          in   the   non-comment   portion   will  be   converted   to
          spaces,  and therefore, cannot be part of a name field.

          The  first  matching  substitution  will  be  selected,   so
          magnification-specific  substitutions should be given first,
          before family substitutions.

          Comments are introduced by percent and continue  to  end-of-
          line,   just  as  for  TeX.   One  whitespace  character  is
          equivalent to any  amount  of  whitespace.   Whitespace  and
          comments are optional.


     SSSSCCCCRRRREEEEEEEENNNN CCCCOOOONNNNTTTTRRRROOOOLLLL
          All switches, including the page  selection  (----oooo)  and  page
          origin  (----xxxx  and  ----yyyy)  switches, work normally.  In order to
          avoid unnecessary waste of screen space, you  probably  will
          want  to  specify ----xxxx0000iiiinnnn and ----yyyy0000iiiinnnn to remove the default one-
          inch left and top margins.  The ----qqqq option is  probably  also
          advisable  to  avoid  warning  messages,  such  as from font
          substitutions.

          At the beginning of a page, a status line  is  displayed  at
          the  bottom  of the screen.  When the end-of-page command is
          reached in the DVI file, or as soon  as  keyboard  input  is
          available,  the  driver  will enter the end-of-page routine.
          Any keyboard input command is  then  read  and  acted  upon;
          unrecognized  input  is  discarded with a warning beep.  The
          advantage of checking for keyboard input during the main DVI
          reading  loop is that unwanted display can be avoided.  This
          is valuable if you are repositioning the page, or skimming a
          document.

          The input can select

               +o  redisplay of the current page, possibly shifting  it



     Page 3                                           (printed 5/6/92)






     TTTTeeeeXXXXssssggggiiii((((1111LLLL))))                 ((((JJJJuuuunnnneeee 1111999988889999))))                 TTTTeeeeXXXXssssggggiiii((((1111LLLL))))



                  up, down, left, or right, or to see more of it.

               +o  continuation to the next page;

               +o  backing up to  the  previous  page  (useful  if  you
                  overshoot);

               +o  display of an arbitrary page by typing its  sequence
                  number;

               +o  termination of execution.

          Here is the current command list.  Input  is  immediate;  no
          terminating  carriage  return  is  necessary.  Consequently,
          typing error correction is  supported  only  for  the  digit
          string command; ending with the letter gggg (goto).


               ^^^^DDDD   Move the display down by 1/32 of screen size.

               dddd or CCCCttttllll----NNNN
                    Move the display down by 1/8 of screen size.

               DDDD    Move the display down by 1/2 of screen size.

               ^^^^UUUU   Move the display up by 1/32 of screen size.

               uuuu or CCCCttttllll----PPPP
                    Move the display up by 1/8 of screen size.

               UUUU    Move the display up by 1/2 of screen size.

               ^^^^LLLL   Move the display left by 1/64 of screen size.

               llll or CCCCttttllll----BBBB
                    Move the display left by 1/16 of screen size.

               LLLL    Move the display left by 1/4 of screen size.

               ^^^^RRRR   Move the display right by 1/64 of screen size.

               rrrr or CCCCttttllll----FFFF
                    Move the display right by 1/16 of screen size.

               RRRR    Move the display right by 1/4 of screen size.

               SSSSPPPPAAAACCCCEEEE or ffff or ++++ or CCCCttttllll----VVVV
                    Display next page.

               ---- or bbbb or AAAAlllltttt----VVVV
                    Redisplay previous page.




     Page 4                                           (printed 5/6/92)






     TTTTeeeeXXXXssssggggiiii((((1111LLLL))))                 ((((JJJJuuuunnnneeee 1111999988889999))))                 TTTTeeeeXXXXssssggggiiii((((1111LLLL))))



               nnnnnnnnnnnn gggg
                    nnn is a digit string; DELETE/RUBOUT and BACKSPACE
                    keys  correct typing errors in it.  Goto to nnnnnnnnnnnn-th
                    page, where document pages are numbered 1, 2, ....
                    The  TeX  page numbers are displayed in the status
                    window.  This  is  a  recursive  display;  if  you
                    respond  at  end-of-page with a _n_e_x_t-_p_a_g_e command,
                    display will revert to the page sequence you  were
                    viewing when you first issued the nnnnnnnnnnnn command.

               iiii    inverse - swap foreground/background colors.

               QQQQ    quiet - toggle the  suppression  of  warnings  and
                    error  messages.  Especially useful to supress the
                    font substitution messages.

               hhhh////HHHH  home - return to home position (top left corner)

               ????    help - print a short command summary.

               mmmm    magnify - Zoom up one magstep (1.2  times  larger)
                    from current size.

               ssss    shrink - Zoom down one magstep (1.2 times smaller)
                    from current size.

               MMMM    magnify - Zoom up five magsteps from current size.

               SSSS    shrink - Zoom  down  five  magsteps  from  current
                    size.

               EEEESSSSCCCC or qqqq or xxxx
                    Quit or exit.


          The MMMM and SSSS commands can be  used  quite  effectively  as  a
          pair. From the default magnification (590), MMMM will cause the
          300dpi fonts to be used  exactly  and  the  SSSS  command  will
          return to exactly 118dpi fonts.

          It  is  likely  that  some  font  magnifications   will   be
          unavailable  for  zooming,  so  do  not  be  alarmed if some
          characters are displayed incorrectly when you do this.   You
          can use the font substitution mechanism (----ffff option above) to
          work around this, or you can ask your font administrator  to
          generate    the    required   magnifications.    When   font
          substitution   happens    because    of    an    unavailable
          magnification, characters of an incorrect size are used with
          the spacing required for the font which TeX used, so  output
          is likely to look peculiar.





     Page 5                                           (printed 5/6/92)






     TTTTeeeeXXXXssssggggiiii((((1111LLLL))))                 ((((JJJJuuuunnnneeee 1111999988889999))))                 TTTTeeeeXXXXssssggggiiii((((1111LLLL))))



     SSSSPPPPEEEECCCCIIIIAAAALLLLSSSS
          The  TeX  \\\\ssssppppeeeecccciiiiaaaallll{{{{}}}}  command  is  intended  to  allow   the
          specification in a ._t_e_x file of a request to the DVI driver,
          usually for the insertion  of  graphical  material  at  that
          point  in the document.  It is currently not implemented and
          will simply issue a warning message.


     EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
          The  behavior  of  the  previewer  can  be   influenced   by
          environment  variables.   Compiled-in internal defaults will
          be provided for any of these which are not  defined.    They
          _m_u_s_t  be  entirely in upper-case, since that is conventional
          on Unix systems.  The  names  currently  recognized  are  as
          follows:

          TEXFONTS   This defines the directory path for finding  font
                     files.  Its  value  is _p_r_e_p_e_n_d_e_d to the name of a
                     TeX font to  get a full  file  specification.   A
                     typical    value    for    _T_E_X_F_O_N_T_S    would   be
                     /_u_s_r/_l_o_c_a_l/_l_i_b/_t_e_x/_f_o_n_t_s/.

          TEXINPUTS  This defines the directory path for finding files
                     which  are  not in the current working directory.
                     It is _p_r_e_p_e_n_d_e_d to file names.  A  typical  value
                     would be /_u_s_r/_l_o_c_a_l/_l_i_b/_t_e_x/_i_n_p_u_t_s/.


     FFFFIIIILLLLEEEESSSS
          There is a startup file ._t_e_x_s_g_i_r_c used to set defaults.  The
          file,  if  it  exists, is read from the users home directory
          and then the current  directory.   This  allows  a  document
          specific override to the defaults.

          The format of the file is  simple,  one  command  per  line,
          arguments seperated by spaces. Here is an example file:

            prefposition 489 1279 0 1023
           inverse
           quiet

          The allowable commands are:

           prefposition <left> <right> <bottom> <top> % in screen coordinates
           prefsize <horizontal> <vertical>           % in pixels
           keepaspect <y> <x>                         % y is to x in integers
           quiet                                      % supress messages
           inverse                                    % run white on black
           magnification <mag>
           showhelp                                   % display help window on startup (default)
           noshowhelp                                 % don't display help window on startup
           helpposition <x> <y>                       % origin of help window



     Page 6                                           (printed 5/6/92)






     TTTTeeeeXXXXssssggggiiii((((1111LLLL))))                 ((((JJJJuuuunnnneeee 1111999988889999))))                 TTTTeeeeXXXXssssggggiiii((((1111LLLL))))



           leftmargin <x>                             % as per -x option
           rightmargin <x>                            % as per -y option


          By default, the user can sweep a window without constraints,
          any one of prefposition, prefsize, keepaspect will constrain
          the resultant window by varying amounts.

          The default runmag is 590, which correponds to 118dpi (118 *
          5  =  590).   The most useful magnifications are those which
          are in the  series  (590  645  710  845  1020  ...  )  which
          corresponds  to magsteps in the 118dpi family. Note that the
          number of fonts that are available reduces  as  the  magstep
          increases  (since  we haven't generated all the fonts at the
          higher magsteps). Probably more useful is the use of magstep
          1500,  this  will force the use of the 300dpi fonts that are
          also used for dvi2ps. This will  significantly  magnify  the
          size of the fonts; great for detail work.

          The values of  _t_e_x_i_n_p_u_t_s  and  _t_e_x_f_o_n_t_s  below  are  system-
          dependent.  Typical  values  are  /_u_s_r/_l_o_c_a_l/_t_e_x/_i_n_p_u_t_s/ and
          /_u_s_r/_l_o_c_a_l/_t_e_x/_f_o_n_t_s/.


          *._d_v_i                   TeX DeVice Independent output file

          *._d_v_i-_e_r_r               TeXsgi error log

          *._s_u_b                   DVI file-specific font  substitution
                                  file

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          dvitype(1), latex(1), tex(1), tr2tex(1), _L_o_c_a_l _L_a_T_e_X _G_u_i_d_e,


     BBBBUUUUGGGGSSSS
          Bugs in either the software or its documentation  should  be
          reported by electronic or postal mail to

          Mike Gigante
          Advanced Computer Graphics Centre
          Royal Melbourne Institute of Technology
          124 Latrobe Street,
          Melbourne, Australia 3001

          +61 3 660 2935
          Email: mg@godzilla.cgl.rmit.oz.au

          or to

          Prof David F. Rogers
          Aerospace Engineering Dept.



     Page 7                                           (printed 5/6/92)






     TTTTeeeeXXXXssssggggiiii((((1111LLLL))))                 ((((JJJJuuuunnnneeee 1111999988889999))))                 TTTTeeeeXXXXssssggggiiii((((1111LLLL))))



          U.S. Naval Academy
          Annapolis, MD 21402, USA

          (301) 267 3283/4/5
          Email: dfr@usna.navy.mil

          who has offered to act as the US distribution point.


     AAAAUUUUTTTTHHHHOOOORRRRSSSS
          This previewer is derived from Nelson Beebe's dviXXX  family
          (available from science.utah.edu), with some ideas from Dick
          Grundwald's TeXsun.

          Mike Gigante of RMIT ported the dvixxx family  to  the  Iris
          and  wrote  all  of  the Iris specific code and modified the
          rest.

          Thanks go to Dave Rogers for being the guinea  pig  and  for
          discussions about where the design is heading.


     BBBBUUUUGGGGSSSS
          There is plenty of stuff in the pipeline for  a  better  UI,
          including  two-up  mode,  pica rules, real-time panning etc.
          Now I just have to get time to work on it...





























     Page 8                                           (printed 5/6/92)



