[Bug #810879] Document that copyfile() can fail if you don't have permissions; also...

diff --git a/Doc/lib/libshutil.tex b/Doc/lib/libshutil.tex
index 17b1daa9c2cc3897a80f4b0a6dd0ae89ab69f848..a84fca960c30988d0e427cf161348ab0d4b61421 100644 (file)
--- a/Doc/lib/libshutil.tex
+++ b/Doc/lib/libshutil.tex
@@ -20,9 +20,11 @@ file type and creator codes will not be correct.
 
 \begin{funcdesc}{copyfile}{src, dst}
   Copy the contents of the file named \var{src} to a file named
-  \var{dst}.  If \var{dst} exists, it will be replaced, otherwise it
-  will be created.  Special files such as character or block devices
-  and pipes cannot not be copied with this function.  \var{src} and
+  \var{dst}.  The destination location must be writable; otherwise, 
+  an \exception{IOError} exception will be raised.
+  If \var{dst} already exists, it will be replaced.  
+  Special files such as character or block devices
+  and pipes cannot be copied with this function.  \var{src} and
   \var{dst} are path names given as strings.
 \end{funcdesc}