Add example to patch documentation

1 files changed, 11 insertions, 0 deletions

diff --git a/docs/patch.txt b/docs/patch.txt
index e166459..e86899c 100644
--- a/docs/patch.txt
+++ b/docs/patch.txt
@@ -108,6 +108,17 @@ patch
     `patch.dict(...)`, `patch.multiple(...)` and `patch.object(...)` are
     available for alternate use-cases.
 
+`patch` as function decorator:
+
+.. doctest::
+
+    >>> @patch('__main__.SomeClass')
+    ... def function(mock_class):
+    ...     print mock_class is SomeClass
+    ...
+    >>> function()
+    True
+
 
 Patching a class replaces the class with a `MagicMock` *instance*. If the
 class is instantiated in the code under test then it will be the