*                                                              atrbt_list
Chapter 9 Input Modes
*
The atrbt_list command sets the graphic input mode to assign attributes from
the current, active graphics input device (GIN), and gets attribute strings
from the specified file.
*
atrbt_list
*
*   Sets graphic input mode for attribute assignment from the current GIN,
*   with attribute strings to come from the specified file.
*
*        attrbt_dig  otype  action  fname
*
*   Sets the graphics input mode to allow assignment of attributes to objects
*   using the current active graphics input device (GIN).  The attribute strings
*   come from the specified file.  	The file may be a dictionary file or other
*   ascii file.  If a full path is not specified, then the dictionaries 
*   directory will be assumed. From the file, all lines with a non-blank 
*   initial character will be truncated at 30 characters and used as attributes.
*   All other lines will be ignored.
*   To begin with, the first line (attribute) is displayed.  It may be assigned
*   to any number of objects by using the  continue  command.  To use subsequent
*   lines as attributes, use the  start  command.  When  start  is used, no
*   attribute will be assigned, but the next line of the file will be read and
*   displayed on the command line area and used as the attribute for 
*   subsequent  continue  commands.   When the end of the list is reached, a 
*   message is printed and the list repeated.  Each attriubte is applied to the 
*   otype object(s) as defined by the action code.  The increment and decrement 
*   commands will behave like the continue command. 
*
*   If the $++ attribute variable is imbedded within the attribute string, it
*   will be replaced with a numeric string as specified by the plus_plus 
*   command.  Each time an attribute containing the $++ string is assigned, the
*   value is incremented.  The initial value can be reset any time by using the
*   plus_plus command.
*   ___________________________________________________________________________
*   Options/arguments:
*
*        otype     Object type code, where:
*                  0 =  node
*                  1 =  segment
*                  2 =  polygon (def=same as map_type value in header)
*        action    Action code, where:
*                  0 =  Replace all attributes w/single new one. 
*                  1 =  Replace/set 1st attribute, leave others. 
*                  2 =  Replace/set 2nd attribute, leave others. 
*                  3 =  Insert new 1st attribute, push others up by one.
*                  4 =  Prefix 1st existing attribute.
*                  5 =  Suffix 1st existing attribute.
*                  6 =  Add a new (additional) last attribute. 
*                  7 =  Remove ALL attributes for one object. 
*                  8 =  Prefix 2nd existing attribute.
*                  9 =  Suffix 2nd existing attribute.
*        fname     File Name of list of attributes (may be a dictionary)
*   ___________________________________________________________________________
*   Note that the following special variable sequences are allowed:
*
*   $record
*
*   This special attribute variable is converted to the object record number
*   when the attribute is assigned.  For example: if the attribute string
*   entered by the user is 'abc$record' and is assigned using atrbt_list,
*   atrbt_rec, atrbt_serial, or atrbt_set to object 123, then the attribute
*   assigned is 'abc123'.
*   ___________________________________________________________________________
*
*
*   $serial
*
*   This special attribute variable is converted to the object serial number
*   when the attribute is assigned.  For example: if the attribute string
*   entered by the user is 'ab$serialzz' and is assigned using atrbt_list,
*   atrbt_rec, atrbt_serial, or atrbt_set to an object with a serial number of
*   999, then the attribute assigned is 'ab999zz'.
*
*   ___________________________________________________________________________
*   $++
*
*   This special attribute variable is replace by a 5 digit integer which can
*   be initialized using the plus_plus command.  Each time an attribute is
*   stroed using the $++ variable substring, the internal value is incremented
*   by 1. 
*   ___________________________________________________________________________
*   Example(s):
*
*   To assign the first line of the dictionary dict1  as the 1st attribute 
*   to the polygon at location  255, 672, enter:
*
*     atrbt_list  2 1 dict1
*     continue 255 672
*
*   To assign the first line of the dictionary  tmbr_codes  as the 2nd 
*   attribute of the polygon at location 255, 672 and the second line of the
*   file to the polygons at 100,300  and 789,1450 enter:
*
*        atrbt_list 2 2 tmbr_codes
*        continue 255, 672
*        start
*        continue 100 300
*        continue 789 1450
*   ___________________________________________________________________________
*   See also:
*
*             atrbt_rec, atrbt_serial, atrbt_set, atrbt_copy, atrbt_dig
*   ___________________________________________________________________________
