]> git.saurik.com Git - wxWidgets.git/blobdiff - wxPython/distrib/README.1st.txt
removed unneeded wx/notebook.h include
[wxWidgets.git] / wxPython / distrib / README.1st.txt
index 29509c6a73fa968462785af07c4d4ba206986778..da8e423eae9a2abb6260f06e313b06f511c2dc20 100644 (file)
-README for wxPythonSrc-*.tar.gz
--------------------------------
+README for wxPython-src-2.5.*.tar.gz
+====================================
 
-Prior to version 2.3.3 of wxPython I had always made my Linux/Unix
-binaries based on the released binary of wxGTK and wxGTK-gl.  This
-imposed a few restrictions and so starting with 2.3.3 I have decided
-to do a combined binary that inlcudes wxGTK as well as wxPython.  This
-allows me a bit more flexibility and is consistent with how the
-Windows and Mac OS X binaries are built.
 
-If you are reading this file then you are probably interested in
-building your own copy of wxPython from the sources contained in this
-archive.  If you wish to use the released wxGTK binary as has been
-done in the past then you can still follow the old build directions in
-wxPython/BUILD.unix.txt.  If you are building for Windows or Mac OS X
-then you should look at wxPython/BUILD.win32.txt or
-wxPython/BUILD.osx.txt respectivly.
+This archive contains the source code and other files for both
+wxWidgets and wxPython.  Some things not needed for the build (such as
+the wxWidgets samples and docs) have been removed in order to minimize
+the size of the archive and are available elsewhere.  If you would
+like to have the complete set of sources and etc. then please either
+use a CVS snapshot from http://wxwindows.org/snapshots/ or do a
+checkout from CVS yourself (see http://www.wxwindows.org/cvs.htm.)  If
+you would like to use CVS to get the exact same sources as one of
+these tarballs then you can update using a release tag.  For example::
 
-If, on the other hand, you would like to build Linux/Unix binaries
-with a private copy of wxGTK like what I am now distributing then
-you'll want to follow the instructions in this file.  (You should
-probably still read wxPython/BUILD.unix.txt though since there are
-other details there that you may need to be aware of.
+      cvs update -r wxPy_2_5_1_0
 
-Clear as mud?  Good.  Let's get started.
 
+For more details about building and installing wxWidgets and wxPython
+please see these files::
 
-1. We'll be making a private copy of wxGTK so it doesn't conflict with
-   one used by wxGTK C++ apps that expect to have the default binary
-   installed from RPM or whatever.  I put it in /usr/lib/wxPython, but
-   you can use whatever you like.  I'll just set a variable to our wx
-   prefix to reference later:
+      wxPython/docs/BUILD.txt
+      wxPython/docs/INSTALL.txt
 
-        export WXPREF=/usr/lib/wxPython
 
+For a log of recent changes check these files::
 
-2. Make a build directory and configure wxGTK.
+      docs/changes.txt             (for wxWidgets)
+      wxPython/docs/CHANGES.txt    (for wxPython)
 
-        cd wxPythonSrc-2.4.0   # or whatever the top-level dir is
-        mkdir build
-        cd build
-        ../configure --with-gtk \
-                     --prefix=$WXPREF \
-                     --enable-rpath=$WXPREF/lib \
-                     --with-opengl \
-                    --enable-geometry \
-                     --enable-optimise \
-                     --enable-debug_flag \
 
-   You may want to use --enable-debug instead of --enable-optimise if
-   you need to run though a debugger and want full debugging symbols.
+And for information about major changes in wxPython 2.5 and how to
+migrate your existing code to 2.5 please read this file::
 
-   if you want to use the image and zlib libraries included with
-   wxWindows instead of those already installed on your system, (for
-   example, to reduce dependencies on 3rd party libraries) then you
-   can add these flags to the configure command:
+      wxPython/docs/MigrationGuide.txt
 
-                     --with-libjpeg=builtin \
-                     --with-libpng=builtin \
-                     --with-libtiff=builtin \
-                     --with-zlib=builtin \
 
-   If you would like to use GTK 2.x and unicode, then add the
-   following flags.  Please note that this is still beta-level
-   quality, but does look and work quite nice for the most part:
+Further information can be found on the wxWidgets and wxPython web
+sites and the project wikis:: 
 
-                    --enable-gtk2 \
-                    --enable-unicode \
+      http://www.wxwindows.org/
+      http://wiki.wxwindows.org/
 
+      http://www.wxpython.org/
+      http://wiki.wxpython.org/
 
-3. Build and install wxGTK.  (You may need to be root for the last
-   step, depending on where your WXPREF is.)
 
-        make
-        make install
+And be sure to direct your questions to one of the various mail
+lists::
 
+      http://www.wxpython.org/maillist.php
 
-4. Build and install wxPython.  If you want to use a different version
-   of Python than is found by default on the PATH then specify the
-   whole pathname in these steps.  The version of Python that runs
-   setup.py is the version wxPython will be built and installed for.
-   (You will need to be root for the install step unless your Python
-   is not in a system location.)
 
-        cd ../wxPython
-        python setup.py \
-               WX_CONFIG=$WXPREF/bin/wx-config \
-               build install
-
-   If you are using GTK 2.x and unicode then do it this way instead:
-
-        python setup.py \
-               WX_CONFIG=$WXPREF/bin/wx-config \
-              WXPORT=gtk2 UNICODE=1 \
-               build install
-
-   If you get errors about wxGLCanvas or being unable to find libGLU
-   or something like that then you can add BUILD_GLCANVAS=0 to the
-   setup.py command line to disable the building of the glcanvas
-   module.
-
-   If you would like to install to someplace besides the Python
-   site-packages directory (such as to your home directory) then you
-   can add "--root=<path>" after the "install" command.  To use
-   wxPython like this you'll need to ensure that the directory
-   containing wxPython is contained in the PYTHONPATH environment
-   variable.
-
-
-5. If you havn't already, get a new copy of the demo and documentation
-   to go with the wxPython you just built and installed.  See
-   http://wxpython.org/download.php#documentation
-
-
-6. Change to the demo directory and run it like this:
-
-        python demo.py
-
-
-7. That's all, except for the having fun part!
 
+Have fun!
 
 
 --