ipy command now includes all of self.py_locals in the IPython environment

1 files changed, 11 insertions, 13 deletions

diff --git a/docs/features/embedded_python_shells.rst b/docs/features/embedded_python_shells.rst
index 8ff65ffe..71fb8197 100644
--- a/docs/features/embedded_python_shells.rst
+++ b/docs/features/embedded_python_shells.rst
@@ -8,19 +8,16 @@ arguments, it enters an interactive Python session.  The session can call
 your ``cmd2`` application while maintaining isolation.
 
 You may optionally enable full access to to your application by setting
-``self_in_py`` to ``True``.  Enabling this flag adds ``self`` to the python
-session, which is a reference to your ``cmd2`` application. This can be useful
-for debugging your application.
+``self.self_in_py`` to ``True``.  Enabling this flag adds ``self`` to the
+python session, which is a reference to your ``cmd2`` application. This can be
+useful for debugging your application.
+
+Anything in ``self.py_locals`` is always available in the Python environment.
 
 The ``app`` object (or your custom name) provides access to application
 commands through raw commands.  For example, any application command call be
 called with ``app("<command>")``.
 
-::
-
-    >>> app('say --piglatin Blah')
-    lahBay
-
 More Python examples:
 
 ::
@@ -114,12 +111,13 @@ be present::
 
 The ``ipy`` command enters an interactive IPython_ session.  Similar to an
 interactive Python session, this shell can access your application instance via
-``self`` and any changes to your application made via ``self`` will persist.
-However, any local or global variable created within the ``ipy`` shell will not
-persist. Within the ``ipy`` shell, you cannot call "back" to your application
-with ``cmd("")``, however you can run commands directly like so::
+``self`` if ``self.self_in_py`` is ``True`` and any changes to your application
+made via ``self`` will persist. However, any local or global variable created
+within the ``ipy`` shell will not persist.
 
-    self.onecmd_plus_hooks('help')
+Also, as in the interactive Python session, the ``ipy`` shell has access to the
+contents of ``self.py_locals`` and can call back into the application using the
+``app`` object (or your custom name).
 
 IPython_ provides many advantages, including: