doc string fixes

Author: d-w-moore

irods/access.py

@@ -129,15 +129,19 @@ def copy(self, decanonicalize=False, implied_zone=''):
         Create a copy of the object, possibly in a normalized form.
 
         Args:
-            decanonicalize: Whether to modify to access_name field to a more human-readable (1/True)
-                or more standard (-1) form.  If the former, then a more organic style is favored, i.e.
+            decanonicalize: Whether to modify to access_name field to a more human-readable (when 1 i.e. True)
+                or more standard form (when -1).  If the former, then a more organic style is favored, i.e.
                 "read" and "write".  If the latter, the new access_name will be more machine-friendly
                 for operators __lt__ (for sorting) and __eq__ (for equivalence or use with 'in').
+                If equal to (0 i.e. False), no adjustment is done.
             implied_zone: If a nonzero-length name, compare this against the zone_name field of the
                 old object, and if they match, force the zone_name to zero-length in the new object.
 
         Returns:
             A copy of the invoking object, normalized if requested.
+
+        Raises:
+            RuntimeError: if decanonicalize parameter is not one of {-1,0,False,1,True}.
         """
         other = copy.deepcopy(self)