Index: trunk/Ohana/src/libohana/doc/glockfile.txt
===================================================================
--- trunk/Ohana/src/libohana/doc/glockfile.txt	(revision 3538)
+++ trunk/Ohana/src/libohana/doc/glockfile.txt	(revision 3649)
@@ -32,14 +32,24 @@
  Error Conditions:
 
- on error, fsetlockfile returns NULL and clears the lock state of the
- file
+ on error, fsetlockfile closes the file, closes the lockfile, and
+ returns NULL.  In come cases, an empty file may be left behind
+ (LCK_TIMEOUT, LCK_HARDOPEN, LCK_HARDLOCK, LCK_HARDLOCKHARD,
+ LCK_HARDLOCKCLOSE)
 
- - invalid type 
- - SOFT and file does not exist
- - file not accessible (cannot be opened)
- - lockfile not accessible
- - cannot lock lockfile (held by another user)
- - lockfile says 'BUSY' (previous holder crashed)
- - cannot unlock lockfile (file system error)
- - error writing 'BUSY' to lockfile
+ - invalid type (LCK_INVALID)
+   * no file created, no lock file created : OK
+ - SOFT and file does not exist (LCK_EMPTY)
+   * no file created, no lock file created : OK 
+ - file not accessible, cannot be opened (LCK_ACCESS)
+   * no file created, no lock file created : OK
+ - FS lock timed out (LCK_TIMEOUT)
+   * new file is created, file is open, file is unlocked, lock file is not created : OK
+ - lockfile not accessible (LCK_HARDOPEN)
+   * new file is created, file is open, file is locked, lock file is not created : OK
+ - cannot lock lockfile, held by another user (LCK_HARDLOCK)
+   * new file is created, file is open, file is locked, lock file is created : OK
+ - lockfile says 'BUSY', previous holder crashed (LCK_HARDLOCKHARD)
+   * new file is created, file is open, file is locked, lock file exists, lock file locked : OK
+ - error writing 'BUSY' to lockfile (LCK_HARDCLOSE)
+   * new file is created, file is open, file is locked, lock file exists, lock file locked