Update documentation for upcoming plugin-ification.

[wizard.git] / wizard / util.py

diff --git a/wizard/util.py b/wizard/util.py
index c33d067edaeacae2f721a5c7a89b04b3ec06f961..5f09ca3e84fb9246a142b15a6b4f806bf16a2bb4 100644 (file)
--- a/wizard/util.py
+++ b/wizard/util.py
@@ -208,9 +208,9 @@ def get_dir_owner(dir = "."):
 
     .. note::
 
-        This function uses the passwd database and thus
-        only works on scripts servers when querying directories
-        that live on AFS.
+        When querying AFS servers, this function only works if
+        you're on a Scripts server (which has the correct passwd
+        database) or if you're on a Debathena machine.
     """
     uid = get_dir_uid(dir)
     try:
@@ -346,14 +346,17 @@ def soft_unlink(file):
         pass
 
 def makedirs(path):
-    """Create a directory path (a la mkdir -p or os.makedirs),
-    but don't complain if it already exists."""
+    """
+    Create a directory path (a la ``mkdir -p`` or ``os.makedirs``),
+    but don't complain if it already exists.
+    """
     try:
         os.makedirs(path)
-    except OSError as exc: # Python >2.5
+    except OSError as exc:
         if exc.errno == errno.EEXIST:
             pass
-        else: raise
+        else:
+            raise
 
 def fetch(host, path, subpath, post=None):
     try: