Patrick O'Brien's PyCrust package has been renamed to Py and now

includes several new tools.  As part of the change the location of the
pacakge has changed as well, it is now accessible as "from wxPython
import py" (or "from wx import py" using the new namespace.)  There
are still some transition moudules in the wxPython.lib.PyCrust mackage
that will issue a warning and then import what is needed from the new
package.  These will be removed in a future release.


git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/branches/WX_2_4_BRANCH@20104 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

wxPython/wxPython/py/MANUAL.txt

@@ -0,0 +1,76 @@
+===============
+ The Py Manual
+===============
+
+-------------------------
+ Py - Served Fresh Daily 
+-------------------------
+
+:Author: Patrick K. O'Brien
+:Contact: pobrien@orbtech.com
+:Date: $Date$
+:Revision: $Revision$
+
+.. contents::
+
+
+Introduction
+============
+
+This document will show you how to make use of the Py programs and
+library of modules.
+
+
+What is Py?
+===========
+
+Py is really several things.  Py is a set of standalone programs as
+well as a library of modules that you can use in your own programs.
+
+First, Py contains standalone programs that provide code editors and
+graphical, Python shell interfaces.  Second, Py contains a collections
+of modules that you can use in your own wxPython applications to
+provide similar services, either for your own use during development,
+or as an interface for users of your program.  Third, Py containss a
+wrapper utility, providing you with runtime introspection capabilities
+for your wxPython programs without having to include PyCrust or
+PyShell in your program, or alter one line of your code.
+
+
+Py standalone programs
+======================
+
+There are several standalone applications in the Py package:
+
+* PyAlaCarte
+* PyAlaMode
+* PyCrust
+* PyFilling
+* PyShell
+* PyWrap
+
+
+Py modules
+==========
+
+Py was designed to be modular.  That means graphical code is kept
+separate from non-graphical code, and many of the Py modules can be
+used by other programs.  Likewise, other programs can supply some of
+the modules needed by Py.  For example, you could supply a customized
+interpreter module and plug it in to the PyCrust standalone
+application.  As long as it supports the minimum functionality
+required, PyCrust will work just as well with your interpreter as with
+its default interpreter.
+
+
+Py runtime wrapper
+==================
+
+The Py wrapper utility (``PyWrap.py``) lets you run an existing
+wxPython program with a PyCrust frame at the same time.  Inside the
+PyCrust shell, the local variable ``app`` is assigned to your
+application instance.  In this way you can introspect your entire
+application within the PyCrust shell and the PyFilling namespace
+viewer.  And through the use of the Py decorator classes, PyCrust can
+display wxPython function and method signatures as well as docstrings
+for the entire wxPython library.