From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Sat, 8 Aug 2020 03:05:04 +0000 (-0700) Subject: Doc: Add a link to tutorial page from `open()` doc (GH-21737) X-Git-Tag: v3.8.6rc1~50 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=de5de413e7f03e9cdcaf0cf96b13f4fe6bd5ccb6;p=thirdparty%2FPython%2Fcpython.git Doc: Add a link to tutorial page from `open()` doc (GH-21737) Adds a link to the "Reading and Writing Files" page so users can more easily discover how file handles are handled with the `with` context manager vs without it. (cherry picked from commit 705f14556545699ab615ec98f707b438f9603767) Co-authored-by: Benjamin Kane --- diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index 0f7df0e5e910..8cf755a0e6b3 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1035,7 +1035,8 @@ are always available. They are listed here in alphabetical order. .. function:: open(file, mode='r', buffering=-1, encoding=None, errors=None, newline=None, closefd=True, opener=None) Open *file* and return a corresponding :term:`file object`. If the file - cannot be opened, an :exc:`OSError` is raised. + cannot be opened, an :exc:`OSError` is raised. See + :ref:`tut-files` for more examples of how to use this function. *file* is a :term:`path-like object` giving the pathname (absolute or relative to the current working directory) of the file to be opened or an