From: Brian Curtin <brian@python.org>
Date: Mon, 10 Feb 2020 17:47:17 +0000 (-0700)
Subject: Remove note saying patch is straightforward (#18431)
X-Git-Tag: v3.9.0a4~91
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=e00c1d0c45975c0e9367f05f8c68bb32d68c2fbf;p=thirdparty%2FPython%2Fcpython.git

Remove note saying patch is straightforward (#18431)

While `unittest.mock.patch` is a great thing, it is not straightforward.
If it were straightforward there wouldn't be such a huge amount of
documentation for it, and frankly, when myself and others who I've
read about often struggle to figure out what on earth `patch()` wants,
coming to the docs to read that it's straightforward is not helpful.
---

diff --git a/Doc/library/unittest.mock.rst b/Doc/library/unittest.mock.rst
index 515bdd060a19..3643d1ad96ed 100644
--- a/Doc/library/unittest.mock.rst
+++ b/Doc/library/unittest.mock.rst
@@ -1327,8 +1327,7 @@ patch
 
 .. note::
 
-    :func:`patch` is straightforward to use. The key is to do the patching in the
-    right namespace. See the section `where to patch`_.
+    The key is to do the patching in the right namespace. See the section `where to patch`_.
 
 .. function:: patch(target, new=DEFAULT, spec=None, create=False, spec_set=None, autospec=None, new_callable=None, **kwargs)