diff options
author | Georg Brandl <georg@python.org> | 2012-03-27 05:46:46 (GMT) |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2012-03-27 05:46:46 (GMT) |
commit | d86440750f7f81a024a9bb2e9053b290ec9b40d4 (patch) | |
tree | 8fd05b1e6ddff45eede33147f0ca31e165b270d9 /Lib/rlcompleter.py | |
parent | 99e7d0706eb4c424be6e648f1b3b69dba6b5aa34 (diff) | |
download | cpython-d86440750f7f81a024a9bb2e9053b290ec9b40d4.zip cpython-d86440750f7f81a024a9bb2e9053b290ec9b40d4.tar.gz cpython-d86440750f7f81a024a9bb2e9053b290ec9b40d4.tar.bz2 |
Closes #14411: remove outdated comment in rlcompleter docstring.
Diffstat (limited to 'Lib/rlcompleter.py')
-rw-r--r-- | Lib/rlcompleter.py | 36 |
1 files changed, 16 insertions, 20 deletions
diff --git a/Lib/rlcompleter.py b/Lib/rlcompleter.py index 8b74ffa..d3a4437 100644 --- a/Lib/rlcompleter.py +++ b/Lib/rlcompleter.py @@ -1,13 +1,11 @@ -"""Word completion for GNU readline 2.0. +"""Word completion for GNU readline. -This requires the latest extension to the readline module. The completer -completes keywords, built-ins and globals in a selectable namespace (which -defaults to __main__); when completing NAME.NAME..., it evaluates (!) the -expression up to the last dot and completes its attributes. +The completer completes keywords, built-ins and globals in a selectable +namespace (which defaults to __main__); when completing NAME.NAME..., it +evaluates (!) the expression up to the last dot and completes its attributes. -It's very cool to do "import sys" type "sys.", hit the -completion key (twice), and see the list of names defined by the -sys module! +It's very cool to do "import sys" type "sys.", hit the completion key (twice), +and see the list of names defined by the sys module! Tip: to use the tab key as the completion key, call @@ -15,21 +13,19 @@ Tip: to use the tab key as the completion key, call Notes: -- Exceptions raised by the completer function are *ignored* (and -generally cause the completion to fail). This is a feature -- since -readline sets the tty device in raw (or cbreak) mode, printing a -traceback wouldn't work well without some complicated hoopla to save, -reset and restore the tty state. +- Exceptions raised by the completer function are *ignored* (and generally cause + the completion to fail). This is a feature -- since readline sets the tty + device in raw (or cbreak) mode, printing a traceback wouldn't work well + without some complicated hoopla to save, reset and restore the tty state. -- The evaluation of the NAME.NAME... form may cause arbitrary -application defined code to be executed if an object with a -__getattr__ hook is found. Since it is the responsibility of the -application (or the user) to enable this feature, I consider this an -acceptable risk. More complicated expressions (e.g. function calls or -indexing operations) are *not* evaluated. +- The evaluation of the NAME.NAME... form may cause arbitrary application + defined code to be executed if an object with a __getattr__ hook is found. + Since it is the responsibility of the application (or the user) to enable this + feature, I consider this an acceptable risk. More complicated expressions + (e.g. function calls or indexing operations) are *not* evaluated. - When the original stdin is not a tty device, GNU readline is never -used, and this module (and the readline module) are silently inactive. + used, and this module (and the readline module) are silently inactive. """ |