--- projects/libstatgrab/docs/statgrab.xml	2004/05/02 17:39:19	1.8
+++ projects/libstatgrab/docs/statgrab.xml	2004/11/01 18:43:03	1.13
@@ -6,8 +6,8 @@
 <refentry id="statgrab">
 
   <refentryinfo>
-    <date>$Date: 2004/05/02 17:39:19 $</date>
-    <releaseinfo>$Id: statgrab.xml,v 1.8 2004/05/02 17:39:19 tdb Exp $</releaseinfo>
+    <date>$Date: 2004/11/01 18:43:03 $</date>
+    <releaseinfo>$Id: statgrab.xml,v 1.13 2004/11/01 18:43:03 tdb Exp $</releaseinfo>
   </refentryinfo>
 
   <refmeta>
@@ -35,6 +35,23 @@
       </funcprototype>
 
       <funcprototype>
+        <funcdef>sg_error <function>sg_get_error</function></funcdef>
+        <void/>
+      </funcprototype>
+      <funcprototype>
+        <funcdef>const char *<function>sg_get_error_arg</function></funcdef>
+        <void/>
+      </funcprototype>
+      <funcprototype>
+        <funcdef>int<function>sg_get_error_errno</function></funcdef>
+        <void/>
+      </funcprototype>
+      <funcprototype>
+        <funcdef>const char *<function>sg_str_error</function></funcdef>
+        <paramdef>sg_error <parameter>code</parameter></paramdef>
+      </funcprototype>
+
+      <funcprototype>
         <funcdef>sg_cpu_stats *<function>sg_get_cpu_stats</function></funcdef>
         <void/>
       </funcprototype>
@@ -57,6 +74,11 @@
       </funcprototype>
 
       <funcprototype>
+        <funcdef>sg_fs_stats *<function>sg_get_fs_stats</function></funcdef>
+        <void/>
+      </funcprototype>
+
+      <funcprototype>
         <funcdef>sg_host_info *<function>sg_get_host_info</function></funcdef>
         <void/>
       </funcprototype>
@@ -139,10 +161,28 @@
       non-zero on failure.
     </para>
     <para>
+      There are three functions relating to error reporting in libstatgrab.
+      The first, <function>sg_get_error</function> returns an sg_error code
+      which relates to the last error generated by libstatgrab. This can be
+      converted to a string by calling <function>sg_str_error</function>
+      giving the sg_error code as an argument. An optional
+      argument may be set when the error was generated. This can be
+      accessed by calling <function>sg_get_error_arg</function>;
+      <constant>NULL</constant> will be returned if no argument has
+      been set. Some errors will also record the value of the system
+      errno variable when the error occurred; this can be retrieved by
+      calling <function>sg_get_error_errno</function>, which will
+      return <constant>0</constant> if no valid errno has been recorded.
+    </para>
+    <para>
+      It is the intended practice that whenever a libstatgrab function is
+      called and subsequently fails that an appropriate error will be set.
+    </para>
+    <para>
       The library was originally written to support the i-scream
       central monitoring system, but has since become a standalone
       package. It has been ported to work on Linux, NetBSD, FreeBSD,
-      OpenBSD, DragonFly BSD, Solaris and Cygwin.
+      OpenBSD, DragonFly BSD, Solaris, HP-UX and Cygwin.
     </para>
   </refsect1>
 
@@ -157,6 +197,10 @@
         </citerefentry>
         <citerefentry>
           <refentrytitle>sg_get_disk_io_stats</refentrytitle>
+          <manvolnum>3</manvolnum>
+        </citerefentry>
+        <citerefentry>
+          <refentrytitle>sg_get_fs_stats</refentrytitle>
           <manvolnum>3</manvolnum>
         </citerefentry>
         <citerefentry>