home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2007 September / PCWSEP07.iso / Software / Linux / Linux Mint 3.0 Light / LinuxMint-3.0-Light.iso / casper / filesystem.squashfs / usr / share / doc / python-gtk2 / README < prev    next >
Encoding:
Text File  |  2007-01-16  |  3.9 KB  |  130 lines
  1. PyGTK
  2. =====
  3. Original author: James Henstridge <james@daa.com.au>
  4. Current maintainer: Johan Dahlin <johan@gnome.org>
  5.  
  6. This archive contains modules that allow you to use gtk in Python
  7. programs.  At present, it is a fairly complete set of bindings.
  8. Despite the low version number, this piece of software is quite
  9. useful, and is usable to write moderately complex programs.  (see the
  10. examples directory for some examples of the simpler programs you could
  11. write).
  12.  
  13. If you have any enhancements or bug reports, please file them in
  14. bugzilla at:
  15.   http://bugzilla.gnome.org/enter_bug.cgi?product=pygtk
  16.  
  17. If you have a patch, file the bug first and then use the "create new
  18. attachment" link on the bug's info page.  My preferred format for
  19. patches is unified diff format (ie. diff -u).  Please don't send me
  20. diffs which don't have any context, as these make it very difficult to
  21. see what the patch does.
  22.  
  23. What's new in PyGTK 2.10
  24. ========================
  25.  
  26. See the wiki page for an overview of the features in PyGTK 2.10:
  27.  
  28. http://live.gnome.org/PyGTK/WhatsNew210
  29.  
  30. New Versions
  31. ============
  32.  
  33. New versions of this package can be found at:
  34.   http://ftp.gnome.org/pub/GNOME/sources/pygtk/
  35.  
  36.  
  37. Mailing list
  38. ============
  39.  
  40. There is a mailing list for pygtk.  You can subscribe to it through
  41. the web interface:
  42.   http://www.daa.com.au/mailman/listinfo/pygtk
  43.  
  44.  
  45. Requirements
  46. ============
  47.   * C compiler (GCC and MSVC supported)
  48.   * Python 2.3.5 or higher
  49.   * PyGObject 2.12.1 or higher
  50.   * Glib 2.8.0 or higher
  51.   * GTK+ 2.8.0 or higher (optional) or
  52.     GTK+ 2.10.0 or higher for 2.10 API
  53.   * libglade 2.5.0 or higher (optional)
  54.   * pycairo 0.5.0 or higher (optional)
  55.   * Numeric (optional)
  56.  
  57. This release is supporting the following GTK+ releases:
  58.  
  59.   2.8.x
  60.   2.10.x
  61.  
  62. To include support for the 2.10 API you'll need GTK+ 2.10.0 etc.
  63.  
  64. Copyright Information
  65. =====================
  66.  
  67. This software is covered by the GNU Lesser General Public Licence
  68. (version 2.1, or if you choose, a later version).  Basically just don't
  69. say you wrote bits you didn't.
  70.  
  71. Compilation
  72. ===========
  73.  
  74. PyGTK uses the standard autotools for the build infrastructure.  To
  75. build, it should be as simple as running:
  76.  
  77.     $ ./configure --prefix=<prefix where python is installed>
  78.     $ make
  79.     $ make install
  80.  
  81. If your Python interpreter isn't in the path, or is not called
  82. "python", you can set the PYTHON environment variable to the full path
  83. of the interpreter:
  84.  
  85.     $ PYTHON=/prefix/bin/python
  86.     $ export PYTHON
  87.  
  88. If configure can't find GTK+, you may need to set the PKG_CONFIG_PATH
  89. environment variable to help it find the libraries.
  90.  
  91. The "make install" target will generate normal and optimised bytecode
  92. for all the .py files.
  93.  
  94. Note. If you're installing to another prefix than the one where python
  95. is installed you'll need to set the PYTHONPATH variable to the
  96. $prefix/lib/pythonX.Y/site-packages directory created by
  97. the PyGTK installation.
  98.  
  99. Upgrading from 0.6.x
  100. ====================
  101.  
  102. The API has changed a fair bit compared to the 0.6.x releases of pygtk
  103. in response to feedback from the mailing list.  The main changes are:
  104.   - no low level procedural interface.  The extension now implements
  105.     the object oriented API directly, rather than layering it on top
  106.     of a procedural API.
  107.   - class names have been shortened.  Eg. instead of gtk.GtkWindow, we
  108.     now have gtk.Window.
  109.   - GDK classes and functions have been moved to the "gtk.gdk" module.
  110.   - the GTK and GDK modules have been removed, with their constants
  111.     being moved into the "gtk" and "gtk.gdk" modules.
  112.  
  113.  
  114. Tests
  115. =====
  116.  
  117. After having compiled and installed pygtk, you may want to test them.
  118. There are a number of example programs available in the examples/
  119. subdirectory.
  120.  
  121.  
  122. Getting Help
  123. ============
  124.  
  125. If you have questions about programming with PyGTK, you might want to
  126. send a message to the mailing list (information on subscribing is
  127. above).  Alternatively, your question may be answered in the FAQ:
  128.  
  129.     http://www.async.com.br/faq/pygtk/?req=index
  130.