##// END OF EJS Templates
remove doc warning that %gui doesn't exist in kernel...
MinRK -
Show More
@@ -1117,20 +1117,8 b' GUI event loop support'
1117 .. versionadded:: 0.11
1117 .. versionadded:: 0.11
1118 The ``%gui`` magic and :mod:`IPython.lib.inputhook`.
1118 The ``%gui`` magic and :mod:`IPython.lib.inputhook`.
1119
1119
1120 .. warning::
1121
1122 All GUI support with the ``%gui`` magic, described in this section, applies
1123 only to the plain terminal IPython, *not* to the Qt console. The Qt console
1124 currently only supports GUI interaction via the ``--pylab`` flag, as
1125 explained :ref:`in the matplotlib section <matplotlib_support>`.
1126
1127 We intend to correct this limitation as soon as possible, you can track our
1128 progress at issue #643_.
1129
1130 .. _643: https://github.com/ipython/ipython/issues/643
1131
1132 IPython has excellent support for working interactively with Graphical User
1120 IPython has excellent support for working interactively with Graphical User
1133 Interface (GUI) toolkits, such as wxPython, PyQt4, PyGTK and Tk. This is
1121 Interface (GUI) toolkits, such as wxPython, PyQt4/PySide, PyGTK and Tk. This is
1134 implemented using Python's builtin ``PyOSInputHook`` hook. This implementation
1122 implemented using Python's builtin ``PyOSInputHook`` hook. This implementation
1135 is extremely robust compared to our previous thread-based version. The
1123 is extremely robust compared to our previous thread-based version. The
1136 advantages of this are:
1124 advantages of this are:
@@ -1147,7 +1135,7 b' For users, enabling GUI event loop integration is simple. You simple use the'
1147 %gui [GUINAME]
1135 %gui [GUINAME]
1148
1136
1149 With no arguments, ``%gui`` removes all GUI support. Valid ``GUINAME``
1137 With no arguments, ``%gui`` removes all GUI support. Valid ``GUINAME``
1150 arguments are ``wx``, ``qt4``, ``gtk`` and ``tk``.
1138 arguments are ``wx``, ``qt``, ``gtk`` and ``tk``.
1151
1139
1152 Thus, to use wxPython interactively and create a running :class:`wx.App`
1140 Thus, to use wxPython interactively and create a running :class:`wx.App`
1153 object, do::
1141 object, do::
@@ -1164,9 +1152,9 b' Interested developers should see the module docstrings for more information,'
1164 but there are a few points that should be mentioned here.
1152 but there are a few points that should be mentioned here.
1165
1153
1166 First, the ``PyOSInputHook`` approach only works in command line settings
1154 First, the ``PyOSInputHook`` approach only works in command line settings
1167 where readline is activated. As indicated in the warning above, we plan on
1155 where readline is activated. The integration with various eventloops
1168 improving the integration of GUI event loops with the standalone kernel used by
1156 is handled somewhat differently (and more simply) when using the standalone
1169 the Qt console and other frontends (issue 643_).
1157 kernel, as in the qtconsole and notebook.
1170
1158
1171 Second, when using the ``PyOSInputHook`` approach, a GUI application should
1159 Second, when using the ``PyOSInputHook`` approach, a GUI application should
1172 *not* start its event loop. Instead all of this is handled by the
1160 *not* start its event loop. Instead all of this is handled by the
General Comments 0
You need to be logged in to leave comments. Login now