added caution about exception raised by chown

1 files changed, 2 insertions, 0 deletions

diff --git a/shellutils.py b/shellutils.py
index 892f54d..99c305f 100644
--- a/shellutils.py
+++ b/shellutils.py
@@ -35,6 +35,8 @@ from logilab.common import STD_BLACKLIST
 def chown(path, login=None, group=None):
     """same as `os.chown` function but accepting user login or group name as
     argument. If login or group is omitted, it's left unchanged.
+
+    Note: you must own the file to chown it (or be root). Otherwise OSError is raised. 
     """
     if login is None:
         uid = -1