DOC: add docstring for override_module

1 files changed, 10 insertions, 1 deletions

diff --git a/numpy/core/overrides.py b/numpy/core/overrides.py
index 1dab8f338..e4d505f06 100644
--- a/numpy/core/overrides.py
+++ b/numpy/core/overrides.py
@@ -151,7 +151,16 @@ def verify_matching_signatures(implementation, dispatcher):
 
 
 def override_module(module):
-    """Decorator for overriding __module__ on a function or class."""
+    """Decorator for overriding __module__ on a function or class.
+
+    Example usage::
+
+        @override_module('numpy')
+        def example():
+            pass
+
+        assert example.__module__ == 'numpy'
+    """
     def decorator(func):
         if module is not None:
             func.__module__ = module