Issue 4478: shutil.copyfile documentation - Python tracker (original) (raw)

$ python3.0 Python 3.0rc3 (r30rc3:67312, Nov 22 2008, 21:38:46)

import shutil shutil.copyfile('/tmp/f', '/tmp/f') Traceback (most recent call last): File "", line 1, in File "/a/lib/python3.0/shutil.py", line 47, in copyfile raise Error("%s and %s are the same file" % (src, dst)) shutil.Error: /tmp/f and /tmp/f are the same file

The Python 3 docs at http://docs.python.org/dev/3.0/library/shutil.html#module-shutil mention that copyfile can raise IOError, but they omit to mention that copyfile can also raise shutil.Error.

Also, just out of interest, I notice that Sphinx now supports the ':raises:' field. Are there any plans for the Python documentation to start using it?