diff options
author | R David Murray <rdmurray@bitdance.com> | 2011-06-18 23:31:22 (GMT) |
---|---|---|
committer | R David Murray <rdmurray@bitdance.com> | 2011-06-18 23:31:22 (GMT) |
commit | 491eb6a17e8b41741d9c2d597e0d6c71cc7867e9 (patch) | |
tree | 2b1e4b58c5a49a12c54499deab42fb37de08090a /Doc/library | |
parent | f1138bb1b6ead7ddeae3e38e3c507d63d09669c3 (diff) | |
download | cpython-491eb6a17e8b41741d9c2d597e0d6c71cc7867e9.zip cpython-491eb6a17e8b41741d9c2d597e0d6c71cc7867e9.tar.gz cpython-491eb6a17e8b41741d9c2d597e0d6c71cc7867e9.tar.bz2 |
#6771: fix docs: curses.wrapper is exposed as a function, not a module
Patch by July Tikhonov.
Diffstat (limited to 'Doc/library')
-rw-r--r-- | Doc/library/curses.rst | 47 |
1 files changed, 13 insertions, 34 deletions
diff --git a/Doc/library/curses.rst b/Doc/library/curses.rst index 63691db..c8e8f87 100644 --- a/Doc/library/curses.rst +++ b/Doc/library/curses.rst @@ -44,10 +44,6 @@ Linux and the BSD variants of Unix. Module :mod:`curses.textpad` Editable text widget for curses supporting :program:`Emacs`\ -like bindings. - Module :mod:`curses.wrapper` - Convenience function to ensure proper terminal setup and resetting on - application entry and exit. - :ref:`curses-howto` Tutorial material on using curses with Python, by Andrew Kuchling and Eric Raymond. @@ -595,6 +591,19 @@ The module :mod:`curses` defines the following functions: foreground color on the default background. +.. function:: wrapper(func, ...) + + Initialize curses and call another callable object, *func*, which should be the + rest of your curses-using application. If the application raises an exception, + this function will restore the terminal to a sane state before re-raising the + exception and generating a traceback. The callable object *func* is then passed + the main window 'stdscr' as its first argument, followed by any other arguments + passed to :func:`wrapper`. Before calling *func*, :func:`wrapper` turns on + cbreak mode, turns off echo, enables the terminal keypad, and initializes colors + if the terminal has color support. On exit (whether normally or by exception) + it restores cooked mode, turns on echo, and disables the terminal keypad. + + .. _curses-window-objects: Window Objects @@ -1665,33 +1674,3 @@ You can instantiate a :class:`Textbox` object as follows: end of that line instead, and trailing blanks are stripped when the window contents are gathered. - -:mod:`curses.wrapper` --- Terminal handler for curses programs -============================================================== - -.. module:: curses.wrapper - :synopsis: Terminal configuration wrapper for curses programs. -.. moduleauthor:: Eric Raymond <esr@thyrsus.com> -.. sectionauthor:: Eric Raymond <esr@thyrsus.com> - - -.. versionadded:: 1.6 - -This module supplies one function, :func:`wrapper`, which runs another function -which should be the rest of your curses-using application. If the application -raises an exception, :func:`wrapper` will restore the terminal to a sane state -before re-raising the exception and generating a traceback. - - -.. function:: wrapper(func, ...) - - Wrapper function that initializes curses and calls another function, *func*, - restoring normal keyboard/screen behavior on error. The callable object *func* - is then passed the main window 'stdscr' as its first argument, followed by any - other arguments passed to :func:`wrapper`. - -Before calling the hook function, :func:`wrapper` turns on cbreak mode, turns -off echo, enables the terminal keypad, and initializes colors if the terminal -has color support. On exit (whether normally or by exception) it restores -cooked mode, turns on echo, and disables the terminal keypad. - |