From 4e3ebe0baeba9a7b4a1dcfcadb8b042aef7eb5fb Mon Sep 17 00:00:00 2001 From: Skip Montanaro Date: Sat, 8 Dec 2007 14:37:43 +0000 Subject: [PATCH] Note that open() is the preferred way to open files (issue 1510). --- Objects/fileobject.c | 3 ++- Python/bltinmodule.c | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/Objects/fileobject.c b/Objects/fileobject.c index 271f4cdc55a..4dd5c712b79 100644 --- a/Objects/fileobject.c +++ b/Objects/fileobject.c @@ -2065,7 +2065,8 @@ PyDoc_STR( "opened for writing. Add a 'b' to the mode for binary files.\n" "Add a '+' to the mode to allow simultaneous reading and writing.\n" "If the buffering argument is given, 0 means unbuffered, 1 means line\n" -"buffered, and larger numbers specify the buffer size.\n" +"buffered, and larger numbers specify the buffer size. The preferred way\n" +"to open a file is with the builtin open() function.\n" ) PyDoc_STR( "Add a 'U' to mode to open the file for input with universal newline\n" diff --git a/Python/bltinmodule.c b/Python/bltinmodule.c index e1242fdede4..92304b3862e 100644 --- a/Python/bltinmodule.c +++ b/Python/bltinmodule.c @@ -1357,7 +1357,8 @@ builtin_open(PyObject *self, PyObject *args, PyObject *kwds) PyDoc_STRVAR(open_doc, "open(name[, mode[, buffering]]) -> file object\n\ \n\ -Open a file using the file() type, returns a file object."); +Open a file using the file() type, returns a file object. This is the\n\ +preferred way to open a file."); static PyObject *