the document file.  We haven't talked about how a program 
   goes about doing so.</P>

<P>When the Viewer library requests that the VILFile library 
   open the document file, it will pass the file's path, 
   encoded as a <STRONG>FoamPathHandle</STRONG>, which is equivalent to 
   a <STRONG>FDocumentDir</STRONG>.  It will also pass the 
   document file's name.  Using a combination of Foam and 
   kernel library routines, your library can open the file 
   and manipulate its contents as shown in the code 