Clarify documentation for mkdtemp.

[libguestfs.git] / python / guestfs.py

diff --git a/python/guestfs.py b/python/guestfs.py
index fec12a7..23aef9c 100644 (file)
--- a/python/guestfs.py
+++ b/python/guestfs.py
@@ -1707,15 +1707,19 @@ class GuestFS:
     def mkdtemp (self, template):
         u"""This command creates a temporary directory. The
         "template" parameter should be a full pathname for the
-        temporary directory with the six characters being
-        "XXXXXX".
+        temporary directory name with the final six characters
+        being "XXXXXX".
         
-        For example: "/tmp/tmpXXXXXX" or "/Temp/tmpXXXXXX", the
-        second one being suitable for Windows.
+        For example: "/tmp/myprogXXXXXX" or
+        "/Temp/myprogXXXXXX", the second one being suitable for
+        Windows filesystems.
         
         The name of the temporary directory that was created is
         returned.
         
+        The temporary directory is created with mode 0700 and is
+        owned by root.
+        
         The caller is responsible for deleting the temporary
         directory and its contents after use.