home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / pytho152.zip / emx / doc / Python / README.OS2 < prev   
Text File  |  2000-08-21  |  3KB  |  69 lines
  1. WHAT'S THIS
  2. -----------
  3.  
  4. This is the interpreter of the well-known Python scripting language.
  5. The reason for yet another binary OS/2 distribution is that it provides
  6. a little more functionality than the original VACPP port (support for
  7. Python modules in DLLs). Another reason is that some functions exported
  8. from Python.dll accepts an FILE* argument, and it is impossible to pass
  9. an EMX' FILE* to the VACPP DLL. It will trap in the best case. So if you
  10. are developing a program that uses Python as the scripting language
  11. (such as the Crystal Space project) you won't be able to use VACPP dll
  12. if you're using the EMX toolset.
  13.  
  14. By default Python will use the GNU readline library for input. GNU readline
  15. will provide miscelaneous input features such as command history, redefinable
  16. keymap and so on; also this means that to quit an interactive Python session
  17. you should press Ctrl+D (and not "Ctrl+Z plus Return" how is suggested if you
  18. type "exit"). Ctrl+Z will work if you remove the lib/python1.5/readline.dll
  19. module, and the input will happen through the "usual" OS/2 line reading
  20. routine.
  21.  
  22.  
  23. INSTALLATION
  24. ------------
  25.  
  26. If you're an developer, just unpack everything on top of the emx
  27. directory. Two small launchers (python.exe and pythonpm.exe) will go
  28. into emx/bin, the dll's will go to emx/dll, the includes and libraries
  29. will go to respective locations.
  30.  
  31. If you're just a regular user, you don't need the includes and the libraries.
  32. In this case you should copy the contents of bin/ directory anywhere
  33. along your PATH; then copy the contents of lib/python1.5 directory
  34. anywhere where you feel it is suitable, for example you may copy
  35. it under OS2/APPS/PYTHON1.5.
  36.  
  37. Then you have to tell PYTHON where to look for his modules. This is
  38. done by adding to your CONFIG.SYS a line like this one:
  39.  
  40.     set PYTHONPATH=f:/emx/lib/python1.5
  41.  
  42.     or
  43.  
  44.     set PYTHONPATH=c:\os2\apps\python1.5
  45.  
  46. Finally, reboot for this change to have effect.
  47.  
  48. Also you may want to copy the GNU readline library initialization file
  49. .inputrc (which should be in same directory) into your home directory,
  50. if you don't have one already there. If you don't have a home directory,
  51. create one anywhere you like, then add to CONFIG.SYS a line like:
  52.  
  53.     set HOME=d:/home/username
  54.  
  55. If you need the Python documentation, download it from www.python.org.
  56.  
  57.  
  58. HOW TO BUILD
  59. ------------
  60.  
  61. To rebuild Python using GCC+EMX:
  62.  
  63.     - Download the sources
  64.     - Apply the patches in src/Python
  65.     - Copy the os2emx directory under PC/os2emx
  66.     - Go to os2emx directory and type "make".
  67.  
  68. Andrew Zabolotny, <bit@eltech.ru>
  69.