home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 4 / AACD04.ISO / AACD / Programming / Python / README < prev    next >
Encoding:
Text File  |  1999-10-24  |  5.9 KB  |  177 lines
  1.  
  2.  
  3.                                PYTHON 1.5.2
  4.                           NOTES ON THE AMIGA PORT
  5.  
  6.                              October 24, 1999.
  7.  
  8.     
  9.            Conversion and Amiga specific code by Irmen de Jong.
  10.               (Original code by Guido van Rossum and others)
  11.  
  12.  
  13.  
  14.                    Read the file <DISCL_and_COPYRIGHT>!
  15.  
  16.    It contains the disclaimer for this software, and copyright notices.
  17.  
  18.  
  19.  
  20.     Contents:
  21.     ~~~~~~~~~
  22.  
  23.     1. What's new?    
  24.     2. General remarks.
  25.     3. Troubleshooting.
  26.     4. Thanks.
  27.  
  28.  
  29. +----------------------+
  30. |                      |
  31. |  1. What's new?      |
  32. |                      |
  33. +----------------------+
  34.  
  35. IMPORTANT CHANGES SINCE THE PREVIOUS VERSION (version 1.5.2 build 1):
  36.  
  37.     - Prints correct string when command `exit' is issued at the prompt.
  38.     - Fixed some missing 1.5.2 issues, like the os.error exception type.
  39.     - A new time.strftime which passes the test.
  40.     - Fixed amiga.crc32 function to comply with CRC32 standards.
  41.  
  42.  
  43. +----------------------+
  44. |                      |
  45. |  2. General remarks  |
  46. |                      |
  47. +----------------------+
  48.  
  49. * The MAIN PYTHON SITE is <http://www.python.org>. All general documentation
  50.   can be obtained from here (Python tutorial, language reference, library
  51.   reference and much more).
  52.  
  53. * The above mentioned documentation is also available on Aminet, as
  54.   dev/lang/Python152_Doc.lha.
  55.  
  56. * The AmigaPython homepage is at http://www.bigfoot.com/~irmen/python.html
  57.   (note the new address!). Check it out for news, future plans, bugs etc.
  58.   You can also obtain the beta I-Net 225 version here.
  59.  
  60. * In the `Docs/Amiga' directory you can find the docs for the Amiga specific
  61.   modules and features. Read them, they contain vital information!
  62.  
  63. * The Python library contains an extensive test set.
  64.   To try it yourself, type (after installation):
  65.     Python -c "import test.autotest" (and have patience...)
  66.     Python -c "import test.autotest" (and have patience...)
  67.   (Yes: do it TWICE because the generated .pyc files need to be checked too).
  68.   (You can also start the RunTest.py script from the Workbench).
  69.   Some tests cannot run on the Amiga - they will be skipped.
  70.   The report at the end should say something like:
  71.     31 tests OK.
  72.     18 tests skipped:  .....
  73.   If you don't start AmiTCP first, test_socket and test_select will fail.
  74.   If usergroup.library cannot be opened, crypt, grp and pwd will fail.
  75.  
  76. * To  see  some  command  line  options,  use  the -?  option, or any other
  77.   unrecognised option.
  78.  
  79. * To run a speed benchmark, type:
  80.     Python -c "import test.pystone; test.pystone.main()"
  81.   and have some patience. On my system, I get 366 pystones/second.
  82.  
  83. * In the `Icons' directory there are some icon suggestions.
  84.   def_py.info is an icon for Python source files (.py)
  85.   def_pyc.info is an icon for Pytnon bytecode files (.pyc)
  86.  
  87. * The following modules are built-in in this release:
  88.   ARexxll Doslib amiga array binascii cPickle cStringIO cmath crypt
  89.   environment errno grp imp marshal math md5 new operator pcre pwd regex
  90.   rotor select sha socket soundex strop struct sys syslog time
  91.  
  92.   Amiga specific: amiga, ARexxll, Doslib, environment
  93.   Needs usergroup.library: crypt, grp, pwd.
  94.   Needs AmiTCP's bsdsocket.library: select, socket, syslog.
  95.  
  96. * Mail  me  if  you encounter any Amiga specific problems, or if you have any
  97.   Amiga  related  questions  about  Python,  or  just  for fun.  General
  98.   questions are better asked on the usenet newsgroup comp.lang.python.  A lot
  99.   of   information,   including  an  online  manual,  can  be  obtained  from
  100.   <http://www.python.org/>. Read the FAQ before asking!
  101.  
  102.  
  103. +-----------------------+
  104. |                       |
  105. |  3. Troubleshooting   |
  106. |                       |
  107. +-----------------------+
  108.  
  109. * When  I  try  to  install  Python,  I  get  "Unable  to  open  your tool
  110.   'installer'"!
  111.  
  112.   The Installer® utility is required for installation, but it is not included
  113.   in  the  archive.   Get  it  from  somewhere  else  and  copy it to your C:
  114.   directory or somewhere where Workbench can find it.
  115.  
  116. * When I start python, I get "This program requires a math co-processor"!
  117.  
  118.   You should upgrade your computer to at least a 68030 with a FPU.
  119.  
  120. * I   get   "Couldn't   open   bsdsocket.library"   or   "Couldn't   open
  121.   usergroup.library" errors!
  122.  
  123.   You  are  trying to use functions that need one of these libraries.  AmiTCP
  124.   is required if you want to use all (network) functions.
  125.  
  126. * Python crashes when executing complex (recursive) code!
  127.  
  128.   This should not happen; you should get a MemoryError exception.  If it does
  129.   crash, increase your stack size and try again.  Python's default stack size
  130.   is 20K, which should be enough for most programs.
  131.  
  132. * Functions which use the PIPE: device (like os.popen) seem to work
  133.   incorrectly!
  134.  
  135.   The default l:queue-handler is buggy.  Make sure you have installed a fixed
  136.   l:queue-handler (I'm using util/sys/HWGQueue.lha from Aminet)
  137.  
  138. * I cannot import Dos or ARexx!
  139.  
  140.   Try `import site' first.
  141.  
  142. * Other errors
  143.  
  144.   Mail me at irmen@bigfoot.com with a clear description of the problem.
  145.  
  146.  
  147. +-----------------------+
  148. |                       |
  149. |  4. Thanks            |
  150. |                       |
  151. +-----------------------+
  152.  
  153. Ofcourse this product could never have happened without the support of various
  154. people. Amongst others I'd like to thank:
  155.  
  156. Guido van Rossum - for creating Python in the first place
  157. Mike Meyer for his various suggestions and problem reports
  158. Kent Polk for his various suggestions and problem reports
  159. Lyster E. Wick for his various contributions (NewIcons/ARexx/WB/bugreports)
  160. Marc Christiansen for his detailed description of the strftime and
  161.   amiga.crc32 problems (and persuading me to fix them)
  162. Bablos to make me start polishing up the embedded python code.
  163.  
  164. And ofcourse thanks to my friends who supported me in the first phase of
  165. this project and pushed me to continue this work (that was LONG ago, in the
  166. Python 1.2 days).
  167.  
  168. If you think your name is missing here, drop me a line!
  169.  
  170. To every AmigaPython user out there: thanks for your interest!
  171.  
  172.  
  173.  
  174.  
  175.                     Irmen de Jong
  176.                     (irmen@bigfoot.com)
  177.