---------------------------------------------------------------------
  CLASS: VolumeInfoList                                --JKH
  PUBLIC METHODS:
    searchBySid()   - search for a volume with given sid
    searchByVolName()  - search for a volume with a given volume name
    searchByVolNum()  - search for a volume with a given volume number
    append()   - appends some VolumeInfo to the list.
   at(i)     - returns a pointer to ith element.
   remove(i) - removes the ith element.
    entries()  - returns the size of the list. (inline)
   operator== - equality operator between two VolumeInfoLists.
   operator= - assignment operator between two VolumeInfoLists.
    clear()    - shrinks the list to size zero and deallocates all info. (inline)
   
  USAGE NOTES:
   User notes go here.
  
 ----------------------------------------------------------------------

---------------------------------------------------------------------
  METHOD:  NSR::VolumeInfoList::append                         --JKH
 
  Appends a new VolumeInfo object to the list.
 
  ARGUMENTS:
 
  const VolumeInfo& vinfo   IN  object to append.
  
  RETURNS:  None.
 
  PRECONDITIONS:  None.
 
  POSTCONDITIONS:
 
  --Memory will be allocated for a new VolumeInfo object; its values will
    be set equal to the argument object; the new object will be appended to
    the list.
 -----------------------------------------------------------------------------
void
NSR::ExtentList::append(const Extent& ext)
void
NSR::FileSetList::append(const FileSetInfo& fsi)
void
NSR::VolumeInfoList::append(const VolumeInfo& vinfo)