guestfs(3): Refresh documentation for private data area keys.
authorRichard W.M. Jones <rjones@redhat.com>
Sat, 30 Apr 2011 23:38:20 +0000 (19:38 -0400)
committerRichard W.M. Jones <rjones@redhat.com>
Wed, 18 May 2011 10:40:31 +0000 (11:40 +0100)
(cherry picked from commit 40f2b698ac765128bfcda5f0db893c95d09ae89a)

src/guestfs.pod

index c537ae9..c19c9b6 100644 (file)
@@ -1961,12 +1961,13 @@ To attach a named piece of data, use the following call:
 
 C<key> is the name to associate with this data, and C<data> is an
 arbitrary pointer (which can be C<NULL>).  Any previous item with the
-same name is overwritten.
+same key is overwritten.
 
-You can use any C<key> you want, but names beginning with an
-underscore character are reserved for internal libguestfs purposes
-(for implementing language bindings).  It is recommended to prefix the
-name with some unique string to avoid collisions with other users.
+You can use any C<key> you want, but your key should I<not> start with
+an underscore character.  Keys beginning with an underscore character
+are reserved for internal libguestfs purposes (eg. for implementing
+language bindings).  It is recommended that you prefix the key with
+some unique string to avoid collisions with other users.
 
 To retrieve the pointer, use: