Add new built-in 'help' which invokes pydoc.help (with a twist).

2 files changed, 19 insertions, 0 deletions

diff --git a/Lib/site.py b/Lib/site.py
index 73b3281..b8174f9 100644
--- a/Lib/site.py
+++ b/Lib/site.py
@@ -236,6 +236,20 @@ __builtin__.license = _Printer(
     [os.path.join(here, os.pardir), here, os.curdir])
 
 
+# Define new built-in 'help'.
+# This is a wrapper around pydoc.help (with a twist).
+
+class _Helper:
+    def __repr__(self):
+        return "Type help() for interactive help, " \
+               "or help(object) for help about object."
+    def __call__(self, *args, **kwds):
+        import pydoc
+        return pydoc.help(*args, **kwds)
+
+__builtin__.help = _Helper()
+
+
 # Set the string encoding used by the Unicode implementation.  The
 # default is 'ascii', but if you're willing to experiment, you can
 # change this.
diff --git a/Misc/NEWS b/Misc/NEWS
index 16850aa..2bf6be4 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -151,6 +151,11 @@ Library
   In standard mode, 'q' and 'Q' are supported on all platforms, and are
   8-byte integral types.
 
+- The site module installs a new built-in function 'help' that invokes
+  pydoc.help.  It must be invoked as 'help()'; when invoked as 'help',
+  it displays a message reminding the user to use 'help()' or
+  'help(object)'.
+
 Tests
 
 - New test_mutants.py runs dict comparisons where the key and value