New submission from steve21 <[EMAIL PROTECTED]>: The documentation entry for os.listdir(path) at html docs at http://docs.python.org/dev/3.0/library/os.html#module-os says:
"os.listdir(path) Return a list containing the names of the entries in the directory. The list is in arbitrary order. It does not include the special entries . and .. even if they are present in the directory. Availability: Unix, Windows. This function can be called with a bytes or string argument. In the bytes case, all filenames will be listed as returned by the underlying API. In the string case, filenames will be decoded using the file system encoding, and skipped if a decoding error occurs." The problem is that nowhere it the above documentation does it describe what the 'path' argument should be ! However, if I do $ Python3.0 >>> import os >>> help(os.listdir) # it does describe 'path' Help on built-in function listdir in module posix: listdir(...) listdir(path) -> list_of_strings Return a list containing the names of the entries in the directory. path: path of directory to list The list is in arbitrary order. It does not include the special entries '.' and '..' even if they are present in the directory. It looks like the html docs are missing some information and out of sync with the module docs. ---------- assignee: georg.brandl components: Documentation messages: 76307 nosy: georg.brandl, steve21 severity: normal status: open title: os.listdir() documentation error versions: Python 3.0 _______________________________________ Python tracker <[EMAIL PROTECTED]> <http://bugs.python.org/issue4404> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com