Index: /trunk/Nebulous-Server/Changes
===================================================================
--- /trunk/Nebulous-Server/Changes	(revision 17677)
+++ /trunk/Nebulous-Server/Changes	(revision 17678)
@@ -2,4 +2,5 @@
 
 0.10
+    - document xattr methods
     - change Nebulous::Server::stat() to not die when passed a non-existant key
     - change listxattr_object() to return an arrayref
Index: /trunk/Nebulous-Server/lib/Nebulous/Server.pod
===================================================================
--- /trunk/Nebulous-Server/lib/Nebulous/Server.pod	(revision 17677)
+++ /trunk/Nebulous-Server/lib/Nebulous/Server.pod	(revision 17678)
@@ -22,5 +22,5 @@
     Nebulous::Server->getxattr_object( $key, $name );
     Nebulous::Server->listxattr_object( $key );
-    Nebulous::Server->removexattr_object( $key );
+    Nebulous::Server->removexattr_object( $key, $name );
     Nebulous::Server->find_objects( $pattern );
     Nebulous::Server->find_instances( $key, $volume );
@@ -75,4 +75,82 @@
 Accepts 2 parameters, all are mandatory.  Returns Boolean true.   Throws an
 exception on error.
+
+=item * setxattr_object( $key, $name, $value, $flags );
+
+Accepts 4 parameters, all are mandatory.  
+
+=over 4
+
+=item C<$key>
+
+Nebulous key to create the xattr on.
+
+=item C<$name>
+
+The xattr's name.
+
+=item C<$value>
+
+The xattr's value.
+
+=item C<$flags>
+
+The xattr key insertion mode flag.  Acceptable value are either C<"create"> or
+C<"replace">.  If the xattr already exists then trying to insert another xattr
+with the same name in C<"create"> mode will fail.
+
+=back
+
+Returns Boolean true on success.  Throws an exception on error.
+
+=item * getxattr_object( $key, $name );
+
+Accepts 2 parameters, all are mandatory.  
+
+=over 4
+
+=item C<$key>
+
+Nebulous key to fetch the xattr from.
+
+=item C<$name>
+
+The xattr's name.
+
+=back
+
+Returns the string value of C<$name> on success.  Throws an exception on error.
+
+=item * listxattr_object( $key );
+
+Accepts 1 mandatory parameter. 
+
+=over 4
+
+=item C<$key>
+
+List all xattrs on this Nebulous key.
+
+=back
+
+Returns an C<ARRAYREF> on success.  Throws an exception on error.
+
+=item * removexattr_object( $key, $name );
+
+Accepts 2 parameters, all are mandatory.  
+
+=over 4
+
+=item C<$key>
+
+Nebulous key to remove the xattr from.
+
+=item C<$name>
+
+The xattr's name.
+
+=back
+
+Returns Boolean true on success.  Throws an exception on error.
 
 =item * find_instance( $key, $volume );