!<ANALYSE
  ANALYSE <cif file>

     These commands are used to read a CIF description into  the  internal
  data structure in preparation for drawing.   A syntax check is performed
  on the CIF as it is read in.  If an error  is  detected  then  the  cell
  containing  the  error is marked and only the Bounding Box for this cell
  will be drawn if an attempt is made to draw the cell.   There are  three
  types of error, namely  WARNINGS (given for the users information):

     ?  Line 234  Cell FRED contains no geometry

  FAULTS (which allow only the bounding box of a cell to be drawn):

     *  Line 545  Point only contains one digit

  and DISASTERS (the ones which never happen?):

     #  Line 999  Internal data structure corrupt - please seek assistance

     The  number  typed  is  the  line number of the source text where the
  error was detected.   The default extension for the input file is CIF.

!>
!<CALL
  CALL  <cell>

     This is used to instruct the system to draw the cell specified.   The
  cell may be specified by the symbol number which the cell has in the CIF
  description of it, or by the comment string if a name has been given  to
  the cell. eg.  CALL 32 or CALL PLAPLA.  If cell names are given,  spaces
  and  case  is ignored,  but apart from this the names must be identical.
  The  call  is done at the current window, level, and layer settings, and 
  the screen is not wiped before drawing, allowing groups of cells  to  be 
  built up.

!>
!<CELLS
  CELLS <outfile>

     This gives a list of the cells defined, their name, number, bounding
  box, whether they will be expanded when drawn.  The cell list is placed
  in a file if one is specified,  but is displayed on the terminal by
  default.
  
!>
!<DEVICE
  DEVICE <device type> <terminal?>

     This informs the system of the type of graphics device which is to
  be used for drawing.  The device type is given on the same line, eg.
          DEVICE CHARLES
          DEVICE 963
          DEVICE 4014
  When the system is entered the null device is set up.  This is may be
  superceded by the type of terminal which is connected to the I/O line
  if it is a Tektronix, Charles terminal, or HP plotter in the case of VAX. 

    If a terminal is specified then that terminal is used for any future
  graphics output. This is useful for selecting a plotter from another
  terminal, after the CIF has been checked.     eg.   DEVICE 7221 TTD7
  which sets the system to use the HP plotter connected to line TTD7 for
  any further graphics.     SEE ALSO 'HELP USE'
  This feature only applies to the VAX implementation of CIFVIEW.

!>
!<DISPOSE
  DISPOSE <cell>

     This causes all the cells which whose symbol number is greater than or
  equal to the specified cell to be deleted.  This is useful if you want to
  look a a new CIF file where some of the symbol numbers would clash, without
  leaving the CIFVIEW program.  If the parameter is '*' then all the symbols
  in the data structure are deleted.

  eg.   DISPOSE 11                    { All symbol >= 11 deleted
        DISPOSE FRED                  { All symbol >= number of FRED deleted
        DISPOSE *                     { All symbols deleted

!>
!<DRAW
  DRAW <cell>

     This caused the cell specified to be drawn on the current graphics
  device.  The cell is drawn so that it will fill the area of the screen
  in the case of an interactive terminal, and the screen is cleared before
  the drawing is started.

  Cells may be specified by the symbol number which the cell has in the CIF
  description of it, or by the cells text name.  eg. CALL 32 or CALL PLAPLA.
  If cell names are given,  spaces and case are ignored, but apart from this
  the names must be identical.

  The special from 'DRAW *' can be used to draw the cell defined with the
  largest symbol number.

!>
!<END
  END or STOP or 'end of input'

     These commands are all ways of either :
  a) stopping a secondary command file and returning to the console; or
  b) stopping the program and returning to VAX command level if there is
     no command file in use.

!>
!<GRID
  GRID <size> <toggle>

     The Grid command will draw a square grid on the graphics terminal
  with the size of squares corresponding to <size>.
  If <toggle> is omitted, the grid is drawn, and the command has no other
  effect.  If <toggle> is set to be ON, then a grid of the size specified
  will be drawn after any other cell displayed.    If toggle is set to be 
  OFF then no grid is drawn, and grids are not drawn until another use of
  the GRID command.    Size defaults to 1 if no size is specified.

  eg.     GRID 2             { draws a 2 lambda grid for this cell only
          GRID 1 ON          { draws a lambda grid after each cell drawn
          GRID OFF           { suppresses the drawing of grids
          GRID ?             { gives the current grid value

!>
!<HELP
  HELP <command>

  The following commands are available on the VAX version of CIFSYS.
  Further details may be found by giving the name of the command for
  which the information is required (eg. HELP CELLS) -

   ANALYSE <cif file>                   CELLS   <out file>
   DEVICE  <device name>                DISPOSE <cell num>
   DRAW    <cell>                       END
   GRID    <size> <toggle>              HELP    <command>
   IDENT   <layer> <colour> <style>     LAYERS  <layer name>
   LEVEL   <number>                     NCIRCLE <number>
   ON      <attribute> <cell>           OFF     <attribute> <cell>
   PAN     <X Y>?                       POINT   <X Y N?>
   REDRAW                               ROTATE  <dir>
   SCALE   <number>                     SETLAM  <number>
   SIZE    <number>                     STOP
   STORE   <file>                       SPEED   <number>
   USE     <file>                       VERSION
   WCALL   <cell>                       WINDOW  <XL YB XR YT>?
   WIPE                                 ZOOM    <XL YB XR YT>?
!>
!<IDENT
  IDENT <layer> <colour> <style>

     This command instructs CIFVIEW to use the colour specified by <colour> 
  and the line style specified by <line style> when it is drawing the 
  layer specified by <layer>.  If colour and layer are omitted then the
  default settings are used.   The colour and style may be specifed by their
  EDWIN number or by the following names -
  colour:  black, blue, red, green
  style:   normal, dotted, chain, short-dash, long-dash

  eg.

  IDENT NG BLUE DOT
  IDENT NB 0 S            { Buried contacts in black (0) and short dashes.
  IDENT NM                { set to be default (blue & normal) for Metal.

!>
!<LAYERS
  LAYERS <layer list>

     The layers used in the IC description may be selectively drawn.   The
  required layer is selected by this command.   Valid layer names are:
              For N-MOS :  ND, NP, NM, NI, NC, NG, NB, NV
              For C-MOS :  CD, CP, CM, CW, CC, CG, CA, CN, CV
  the first character will be added by CIFSYS if it is omitted.
  LAYERS with no parameters causes all layers to be drawn (the default).
     Multiple layer names may be specified by the use of + or - between
  layer names.
  eg.
     LAYER CC                    { Draw only CC
     LAYERS P + D                { Draw NP + ND or CP + CD
     LAYERS NG + I + M           { Draw NP + NI + NM
     LAYERS -NB                  { Draw the current layers except for NB
     LAYERS +NC                  { Draw the current layers plus NB

!>
!<LEVEL
  LEVEL <number>

     This  is  a feature to stop large drawings being swamped by excessive
  detail.   Once the level has reached the value specified,  only an BB is
  drawn for a cell call. The default is level 99. If CIFSYS starts to draw
  a cell with more detail than expected,  enter the escape  character  for
  the system which you are using  (^C for VAX, ESC on EMAS, ^G on MOUSES).
  The response  'Int:'  will be received.   The user can then respond with
  a single word, eg 'ENOUGH', followed by return,  in  which  case  CIFSYS
  aborts the current plot, and returns to receive the next user command.
  If  an  escape  must  be  used  on the HP plotter, the BREAK key must be 
  depressed first.

!>
!<NCIRCLE
  NCIRCLE <number>

     If round flashes are  included  in  the  CIF  description,  then  the
  circles  are  approximated to polygons for drawing.   The default is for
  these polygons to be octagons, but  this  command  allows  the  user  to
  increase  the  number of sides used to draw circles.   The default is 8,
  and a value of 16 produces quite respectable circles.

!>
!<OFF
  OFF <attribute> <cell id>
  ON  <attribute> <cell id>

     These commands are used to turn attributes of the cell on or off.
  Currently there are only two attributes, BB which is whether only a
  Bounding Box will be drawn if the cell is instanced, and ID which is
  whether cell identification is to appear on any plots.  The settings
  of these values are shown by the command CELLS.
  
     If <cell id> is omitted or is '*' then all the cells have their
  attribute changed, otherwise only the cell mentioned is altered.

  eg.    ON BB Padin             { Set bounding box on cell 'padin'
         OFF ID Padout           { Suppress writing 'Padout' when drawing.
         ON ID                   { enable all cell names to be drawn.
         OFF BB                  { Don't draw BB for any cell.

!>
!<ON
  ON  <attribute> <cell id>
  OFF <attribute> <cell id>

     These commands are used to turn attributes of the cell on or off.
  Currently there are only two attributes, BB which is whether only a
  Bounding Box will be drawn if the cell is instanced, and ID which is
  whether cell identification is to appear on any plots.  The settings
  of these values are shown by the command CELLS.
  
     If <cell id> is omitted or is '*' then all the cells have their
  attribute changed, otherwise only the cell mentioned is altered.

  eg.    ON BB Padin             { Set bounding box on cell 'padin'
         OFF ID Padout           { Suppress writing 'Padout' when drawing.
         ON ID                   { enable all cell names to be drawn.
         OFF BB                  { Don't draw BB for any cell.

!>
!<PAN
  PAN <X?> <Y?>

     This allows the user to specify a new window relative to the current
  one, and the last cell which was drawn by the DRAW command is re-drawn
  with the revised window setting.

  If the line includes the parameters X or Y then the cell is moved by
  (X, Y) units, relative to the current window.   The parameter Y may be
  omitted, and it defaults to zero.

  If no parameter is specified the user can use the cursor to specify two
  points whose displacement is used as the distance that the window will
  be moved.

  eg.     PAN 10                    { Moves the picture 10 units right
          PAN 50 50                 { 50 units up and right
          PAN -100 -100             { 100 units left and down
          PAN                       { Cursor to specify new position

!>
!<POINT
  POINT <x> <y> <n?>

     The command POINT can be used either to mark a  known  point  on  the
  graphics terminal being used,   or  it can use graphics input facilities
  of the terminal to enquire the coordinates of a point on the screen.

     If a parameter is given a 'marker'  (a small symbol)  is drawn at the
  point (X, Y), the type of marker being specified by N. The type defaults
  to a cross if it is not specified.  The assignment of numbers to markers
  (in the range 0-10) is the same as used by EDWIN.   (See the EDWIN Users
  Guide for further details).

     If no parameter is specified then the user can use the cursor, mouse,
  etc. to identify a point on the screen, and the points coordinates (in
  lambda) are reported to the user.

!>
!<REDRAW
  REDRAW

      This command can be used to re-draw the last cell specifed by the DRAW
  command.    It can be used after the user has altered the layers which are
  to be drawn, the level which the cell is to be expanded to, or the setting
  of the window.   The screen is cleared before the cell is re-drawn.

!>
!<ROTATE
  ROTATE <dir>

      This command specifies a base rotation which is applied to the commands
  DRAW and REDRAW.  Initially there is no base rotation, and the user can
  subsequently select either a clockwise or anti-clockwise rotation of 90
  degrees.   If the ANALYSE command is used the base rotation is reset to
  be zero.

  eg.   ROTATE                { Returns to zero base rotation
        ROTATE -90            { Rotates the picture 90' CW
        ROTATE +90            { Rotates the picture 90' ACW
        ROTATE ?              { States what the current base rotation is.

!>
!<SCALE
  SCALE <number>

     Coordinates in CIF are defined to be 100ths of a micron, as most users
  use ILAP to produce their CIF, and work in terms of LAMBDA, the numbers
  numbers used by CIFSYS are also in terms of Lambda.  This command may be 
  used to reset the scale factor which is applied to convert the CIF points
  into units of Lambda.   The default is currently a Lambda of 3, thus the
  command   SCALE 1  will give the units in terms of 100ths of a micron,
  and   SCALE 300  restores the scale to be in terms of Lambda.  Note that 
  if the CIF was in terms of a Lambda of 2.5 then the command SCALE 250 may
  be used.

!>
!<SETLAM
  SETLAM <number>

    This command may be used to set LAMBDA to a specific dimension on the
  HP plotter.  The area that the picture is drawn in is scaled so that 
  measurements can be made from the plot. If no units are specified
  then the number is assumed to be in centimeters,  it is assumed to be
  inches if the line ends in '"' or 'ins'.
  If the plot can't be drawn on the current paper size, (SIZE), then
  the option is given of plotting the picture over multiple sheets.
  If a number is not specified, LAMBDA is not significant while plotting,
  (the default).

  eg.   SETLAM 0.5        { Lambda will be 0.5 cm on further plots.
        SETLAM 0.01 "     { Lambda set to 0.01" for future plots.
        SETLAM            { Lambda is no longer significant when ploting.

!>
!<SIZE
  SIZE <X> <Y?> <OX?> <OY?>

     This command may be used to set the area on a plotter, which  is  used
  to draw a picture.  If no units are specified then the size is assumed to
  be in centimeters.    Inches are used if the line ends with '"' or 'ins'.
  A square area is set if the Y size is omitted.  OX and OY are an optional
  offset for the lower bounds, which default to zero if they are not given.
  If X and Y are both omitted then the user can specify the size by moving
  the pen to the paper bounds, and pressing the ENTER button.

   eg.  SIZE               { sets plotting area to what user
                           { indicates by moving pen.
        SIZE 20            { sets plotting area to a 20 cm square.
        SIZE 5 4 "         { sets plotting area to a 5" x 4" rect.
        SIZE 3.5 6.7 ins   { sets plotting area to 3.5" x 6.7".
        SIZE 10 15 5 3     { plotting area is 10 x 15 cm rectangle offset
                             by 5 cm in the X direction, and 3 cm in Y.

!>
!<SPEED
  SPEED <n>

    This command may be used to set the plotting speed for HP plotters.
  The default (and fastest) is 36 cm/s for the small plotters and 60 cm/s
  for the large plotters.  A speed of 10 cm/s is recomended for the drawing
  of slides, or if the pens are old.   A number outside the range of speeds
  valid for the plotter causes the default to be used.

  eg.     SPEED 10
 

!>
!<STORE
  STORE <file name>

     If the user wishes to generate an EDWIN Psuedo Display File for
  moving to another system, then this command is used. The parameter is
  the file name in which CIFVIEW should store the picture description.
  After STORE has been called any pictures which are generated by the 
  use of the DRAW or REDRAW commands are also recorded in the file
  which was specified as a parameter to STORE.

     Storing can be disabled by specifying the null stream, 'NL:', as the
  file name.

!>
!<USE
  USE <file name>

     This instructs the system to  use  the file specified for further
  command input.  Secondary input files may not be nested. If the file
  exists  in  the system directory of useful files then this file will
  be used,  otherwise the file is searched for in the users directory.
  When the file finishes the input is reset to the terminal.
  The default extension is COM.

  The currently defined 'useful' files are -

      USE A4        to set the plotter to draw on A4 paper.
      USE A3        to set the plotter to draw on A3 paper.
      USE NMOS8     to set the colours so that all 8 plotter pens are used.
      USE HPA       to select HP plotter A
      USE HPB       to select HP plotter B
      USE BIGHP     to select the HP 7580 plotter.
      USE SLIDES    to set the paper size and plotter speed for slides.
      USE STATE     to give the current 'state' of CIFVIEW.

!>
!<VERSION
  VERSION

     This command prints the release date of the version of CIFSYS in use
  on the users console.   The version should be quoted when reporting any
  problems.
 
!>
!<WCALL
  WCALL <cell>

      This command can be used to re-draw the cell specifed as the parameter.
  It clears the screen before the cell is drawn, but the window is not altered.
  This is useful when plotting, where you do not wish to use DRAW and ZOOM.

!>
!<WINDOW
  WINDOW <a> <b> <c> <d>

     This sets the window to be the box given by the coordinates (a,b) and
  (c,d).  Note that this is done explicitly by the commands DRAW and ZOOM.

      If no parameters are specified then the device is assumed to have a
  method of inputing coordinates graphically, and the user is prompted for
  the two window bounds by means of the mouse, cursor etc.
  The bounds may be specified in any order.

      Windows set by the WINDOW and ZOOM commands are stacked,  (currently
  to a depth of 7). This stack is reset by the use of the DRAW command, or
  can be unwound by giving the command ZOOM with the parameter '^'.

  eg.   WINDOW 50 -50 100 10    { Sets a window to the area specifed
        WINDOW ?                { gives the current window value

!>
!<WIPE
  WIPE

     This causes the 'new frame action' for the device to occur
  (eg.  The screen is cleared).

!>
!<ZOOM
  ZOOM <a> <b> <c> <d>

     This sets the window to be the box given by the coordinates (a,b) and
  (c,d), and the last cell specifed to the DRAW command will be re-drawn
  with the current window setting.

      If no parameters are specified then the device is assumed to have a
  method of inputing coordinates graphically, and the user is prompted for
  the two window bounds by means of the mouse, cursor etc.
  The bounds may be specified in any order.

      Windows set by the WINDOW and ZOOM commands are stacked,  (currently
  to a depth of 7). This stack is reset by the use of the DRAW command, or
  can be unwound by giving the command ZOOM with the parameter '^'.

  eg.   ZOOM             { Sets a window with the cursor & redraws cell
        ZOOM ^           { returns to the previous window & redraws cell
        ZOOM ?           { gives the current window value
!>