Index: /trunk/Nebulous/lib/Nebulous/Client.pod
===================================================================
--- /trunk/Nebulous/lib/Nebulous/Client.pod	(revision 5662)
+++ /trunk/Nebulous/lib/Nebulous/Client.pod	(revision 5663)
@@ -13,5 +13,6 @@
     );
 
-    my $fh = $neb->create( "key", 0, "node01", "example" );
+    my $filename = $neb->create( "key", 0, "node01", "example" );
+    my $fh = $neb->open_create( "key", 0, "node01", "example" );
     $neb->replicate( "key", "node01" );
     $neb->cull( "key" );
@@ -87,4 +88,37 @@
 =item * create($key, $class, $volume, $comment).
 
+Creates a new storage object.
+
+=over 4
+
+=item * key
+
+The storage object key (name).
+
+=item * class 
+
+The storage class.
+
+This parameter is optional.
+
+=item * volume
+
+The preferred storage location of initial instance.
+
+This parameter is optional.
+
+=item * comment 
+
+The storage object comment.
+
+This parameter is optional.
+
+=back
+
+Returns a local filename or C<undef> on failure.
+
+
+=item * open_create($key, $class, $volume, $comment).
+
 Creates and opens new storage object.