---------------------------------------------------------------------
  CLASS: PathElementList     --DVM
  PUBLIC METHODS:
    PathElementList()  - Constructor: optional size slots reserved.
    error()            - Returns error state (inline)
    clear()            - empties and deallocates the list contents
    operator[]()       - accesses ith PathElement
    append()           - Appends an element to list
    remove()           - removes ith PathElement
    getCount()         - returns number of entries
    totalBytes()       - returns number of bytes to write list (inline)
 
  USAGE NOTES:
   This has value-based semantics, where the allocation and
   deallocation of space for list entries are done by this class.
 
   An example of how a name is represented as a PathElementList is
   provided below:
 
   Path(using UNIX conventions):
  
       '../mydir/myFile.h'
 
   PathElementList contents:
 
       Name        Type
       ----------- -----------
       ""          path_Parent
       "mydir"     path_Name
       "myFile.h"  path_Name
  
 ----------------------------------------------------------------------

---------------------------------------------------------------------
    unsigned getCount() const { return count; }



---------------------------------------------------------------------
  NOTES:
   (none.)
 
 ----------------------------------------------------------------------


---------------------------------------------------------------------
 
  ERRORS:  error_No_free_store  - new failed.
  
 ----------------------------------------------------------------------


---------------------------------------------------------------------
  ERRORS:  error_Index_out_of_bounds  - Assigned to location outside
                                        of list. 
 
 ----------------------------------------------------------------------


---------------------------------------------------------------------
  ERRORS:
   error_No_free_store  - new failed.
  
 ----------------------------------------------------------------------