From 40f2b698ac765128bfcda5f0db893c95d09ae89a Mon Sep 17 00:00:00 2001 From: "Richard W.M. Jones" Date: Sat, 30 Apr 2011 19:38:20 -0400 Subject: [PATCH] guestfs(3): Refresh documentation for private data area keys. --- src/guestfs.pod | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/src/guestfs.pod b/src/guestfs.pod index e546029..7cfd2b2 100644 --- a/src/guestfs.pod +++ b/src/guestfs.pod @@ -1962,12 +1962,13 @@ To attach a named piece of data, use the following call: C is the name to associate with this data, and C is an arbitrary pointer (which can be C). Any previous item with the -same name is overwritten. +same key is overwritten. -You can use any C 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 you want, but your key should I 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: -- 1.8.3.1