From: Raymond Hettinger <rhettinger@users.noreply.github.com>
Date: Sat, 3 Apr 2021 20:09:01 +0000 (-0700)
Subject: Replace broken example code with correct simpler code. (GH-25162)
X-Git-Tag: v3.10.0a7~13
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=c5354c045c1067549554c35485a12afdcf88a202;p=thirdparty%2FPython%2Fcpython.git

Replace broken example code with correct simpler code. (GH-25162)

The open() was missing 'w' to indicate it was in a write-mode.
Even then, the open().close() operation was distracting because
it is an unusual way to "touch" as file.  Using os.remove()
instead is simpler and less distracting.
---

diff --git a/Doc/howto/descriptor.rst b/Doc/howto/descriptor.rst
index 819401ea1385..bf026f4b7e61 100644
--- a/Doc/howto/descriptor.rst
+++ b/Doc/howto/descriptor.rst
@@ -115,9 +115,9 @@ different, updated answers each time::
     20
     >>> g.size                              # The games directory has three files
     3
-    >>> open('games/newfile').close()       # Add a fourth file to the directory
+    >>> os.remove('games/chess')            # Delete a game
     >>> g.size                              # File count is automatically updated
-    4
+    2
 
 Besides showing how descriptors can run computations, this example also
 reveals the purpose of the parameters to :meth:`__get__`.  The *self*