Index: Modules/_io/_iomodule.c =================================================================== --- Modules/_io/_iomodule.c (revision 76628) +++ Modules/_io/_iomodule.c (working copy) @@ -176,13 +176,21 @@ * The main open() function */ PyDoc_STRVAR(open_doc, +"open(file_name_or_path) -> file object for reading in text mode\n" +"open(file_name_or_path, mode=binary_mode[, buffering]) -> file object\n" +"open(file_name_or_path[, mode=text_mode[, buffering[, encoding\n" +" [, errors[, newline]]]]]) -> file object\n" +"open(file_descriptor[, ...[, closefd]]) -> file object\n" +"\n" "Open file and return a stream. Raise IOError upon failure.\n" "\n" -"file is either a text or byte string giving the name (and the path\n" -"if the file isn't in the current working directory) of the file to\n" -"be opened or an integer file descriptor of the file to be\n" -"wrapped. (If a file descriptor is given, it is closed when the\n" -"returned I/O object is closed, unless closefd is set to False.)\n" +"file_name_or_path is either a text or byte string giving the name\n" +"(and the path if the file isn't in the current working directory)\n" +"of the file to be opened.\n" +"\n" +"file_descriptor is an integer file descriptor of the file to be\n" +"wrapped. The file descriptor is closed when the returned I/O object\n" +"is closed, unless closefd is set to False.\n" "\n" "mode is an optional string that specifies the mode in which the file\n" "is opened. It defaults to 'r' which means open for reading in text\n"