home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 4 / AACD04.ISO / AACD / Programming / Python / Source / README.AMIGA < prev    next >
Encoding:
Text File  |  1999-10-20  |  7.7 KB  |  228 lines
  1.  
  2. README text for the source code for Amiga Python 1.5
  3.  
  4.  
  5. Contents:
  6. ----------
  7.  Requirements
  8.  Installation/Build instructions
  9.  AmiTCP / I-Net225 / No Network versions
  10.  68000 or 68010 version
  11.  Changing other compiler options
  12.  Notes
  13.  IMPORTANT
  14.  THANKS
  15.  Disclaimer & copyright.
  16.  
  17.  
  18.  
  19. Requirements
  20. ------------
  21.  
  22. - SAS/C 6.5x
  23.   Sorry but you must change *A LOT* to compile with other compilers.
  24.   Please use the latest version of SAS/C (6.58).
  25.  
  26. - Networking SDK: AmiTCP SDK version 4.3, on Aminet (in comm/tcp).
  27.   Maybe version 3 works too (haven't tried it).
  28.  
  29.   Sorry but the INET-225 support is gone for now. Details are in the
  30.   INET-225 directory.
  31.  
  32. - Some 8 Mb free harddisk space to compile all code.
  33.  
  34. - Regular AmigaPython distribution to actually run AmigaPython,
  35.   because it contains the needed library files and testset.
  36.  
  37.  
  38.  
  39. Installation/Build instructions
  40. -------------------------------
  41.  
  42. First extract the archive.  Duh, you probably figured this out otherwise
  43. you would't be reading this.
  44.  
  45. Copy the contents of the LinkLib/ directory to LIB:.  These files are my
  46. memory pools startup and library code to accelerate malloc() and other
  47. memory allocation functions.
  48.  
  49. Then cd to the root directory containing the main SMAKEFILE, and type
  50. 'smake'.  After some time you'll end up with a Python executable in this
  51. drawer called 'Python_030'.
  52.  
  53. You should ignore the warnings.
  54.  
  55. When compilation finishes, RUN THE TESTSET with your new executable!  This
  56. is very important!  The testset is part of the Python library and you
  57. should look in the Python distribution for these files, and more info
  58. (Aminet:  dev/lang/Python15.lha).
  59.  
  60. The executable should be placed in the Python:  directory, which will be
  61. created by the installer script from the above mentioned distribution.
  62. Usually you would rename the Python executable to 'Python'.
  63.  
  64.  
  65.  
  66. AmiTCP / I-Net225 / No Network versions
  67. ---------------------------------------
  68.  
  69. By default, AmiTCP is assumed to be used as TCP stack.  I've added some
  70. checks in the code to make sure -at runtime- that AmiTCP exists.  If it
  71. doesn't, AmigaPython runs fine but you just can't use any network
  72. functionality.
  73.  
  74. If you would like to have a fully "clean" "No-network" version, do the
  75. following:
  76. - Copy SCOPTIONS_NONET to SCOPTIONS, and SMAKEFILE_NONET to SMAKEFILE.
  77. - Change in Modules/SMAKEFILE the $(NETOBJECTS) to $(OBJECTS) where
  78.    indicated.
  79. - Recompile everything.
  80. This will solve any problems that could be caused by network/AmiTCP code,
  81. but it also makes AmigaPython less powerful.
  82.  
  83. Sorry but the INET-225 support is gone for now.  Details are in the
  84. INET-225 directory.
  85.  
  86.  
  87. 68000 or 68010 version
  88. ----------------------
  89.  
  90. AmigaPython doesn't run on a 68000 or 68010 CPU out-of-the-box.  You'll
  91. have to change compiler options to CPU=ANY and MATH=IEEE (instead of
  92. CPU=68030 and MATH=881).  BUT there is at least one other place I know of
  93. that requires additional changes to make it work:  the crc32 code in the
  94. Amiga directory.  You'll have to edit the SMAKEFILE in the Amiga directory
  95. and look for a comment "...change to M68000...".  Change the DEFINE on that
  96. line accordingly.  Otherwise the 68020+ version is assembled...  KRASH.
  97. You probably want to change the "Python_030" name in the SMAKEFILE to
  98. "Python_000" too.
  99.  
  100. AmigaPython should run nicely out-of-the-box on a 68020 system provided it
  101. also has a FPU (68881/2).  I can't test this myself so please notify me if
  102. I'm wrong.
  103.  
  104.  
  105. Changing other compiler options
  106. -------------------------------
  107.  
  108. In the rare event that you would want to change compiler options and things
  109. like that, look in the following files:  SCOPTIONS, SMAKEFILE,
  110. include/config.h, include/config.c, include/osdefs.h.  If you change
  111. anything you'd better rebuild the thing from scratch.  (type 'smake clean'
  112. and then 'smake').
  113.  
  114.  
  115. Notes
  116. -----
  117.  
  118. Documentation and library files are NOT included.  Grab the distribution
  119. release from Aminet (dev/lang/Python.lha) to get them.  Only then you'll
  120. be able to actually do something with Python.
  121.  
  122. Ofcourse the main Python site (http://www.python.org/) is a vital source of
  123. information.
  124.  
  125. Some tests from the testset fail, others are skipped because they cannot
  126. run on the Amiga.  The crypt, grp, pwd, select and socket tests fail if
  127. bsdsocket.library (AmiTCP) or socket.library (I-Net 225) and/or
  128. usergroup.library cannot be opened.
  129.  
  130. Contact me for any information (irmen@bigfoot.com).
  131. My Amiga Python Homepage: http://www.bigfoot.com/~irmen/python.html
  132.  
  133.  
  134.  
  135. *** IMPORTANT ***
  136. -----------------
  137.  
  138. I don't fancy ten different versions of AmigaPython floating around.  So
  139. *please* if you made a change or enhancement or fix, contact me and if it's
  140. good it will be merged in the `official' AmigaPython version (mine).  That
  141. way, everyone can profit from it.  Thanks!
  142.  
  143.  
  144. *** THANKS ***
  145. --------------
  146.  
  147. Ofcourse this product could never have happened without the support of various
  148. people. Amongst others I'd like to thank:
  149.  
  150. Guido van Rossum - for creating Python in the first place
  151. Mike Meyer for his various suggestions and problem reports
  152. Kent Polk for his various suggestions and problem reports
  153. Lyster E. Wick for his various contributions (NewIcons/ARexx/WB/bugreports)
  154. Marc Christiansen for his detailed description of the strftime and
  155.   amiga.crc32 problems (and persuading me to fix them)
  156. Bablos to make me start polishing up the embedded python code.
  157.  
  158. And ofcourse thanks to my friends who supported me in the first phase of
  159. this project and pushed me to continue this work (that was LONG ago, in the
  160. Python 1.2 days).
  161.  
  162. If you think your name is missing here, drop me a line!
  163.  
  164. To every AmigaPython user out there: thanks for your interest!
  165.  
  166.  
  167.  
  168.                     Irmen de Jong
  169.                     irmen@bigfoot.com
  170.                     October 19, 1999
  171.  
  172.  
  173.  
  174.  
  175.  
  176.     DISCLAIMER:
  177.  
  178. I  tried  to  make this program error-free and safe to use, for your and my
  179. own  benefit.   This  disclamer  applies  to the (small) part of the code I
  180. wrote  myself.   The  disclamer  from  the  copyright notice from Stichting
  181. Mathematisch  Centrum  (included  below)  applies  to the rest of the code,
  182. written by Guido van Rossum and others.
  183.   
  184. I  provide  this program "as is".  USE THE PROGRAM AT YOUR OWN RISK.  In no
  185. event will I be liable for damages to you - whether they arise from the use
  186. of  this  program  or  the  inability to use it, whether they are direct or
  187. consequential,  including,  but  not  limited  to,  the loss of data or the
  188. generation of inaccurate data.  No warranties are made.
  189.  
  190.  
  191.         Irmen de Jong.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.     PYTHON COPYRIGHT NOTICE:
  198.  
  199.  
  200. Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam,
  201. The Netherlands.
  202.  
  203.                         All Rights Reserved
  204.  
  205. Permission to use, copy, modify, and distribute this software and its
  206. documentation for any purpose and without fee is hereby granted,
  207. provided that the above copyright notice appear in all copies and that
  208. both that copyright notice and this permission notice appear in
  209. supporting documentation, and that the names of Stichting Mathematisch
  210. Centrum or CWI or Corporation for National Research Initiatives or
  211. CNRI not be used in advertising or publicity pertaining to
  212. distribution of the software without specific, written prior
  213. permission.
  214.  
  215. While CWI is the initial source for this software, a modified version
  216. is made available by the Corporation for National Research Initiatives
  217. (CNRI) at the Internet address ftp://ftp.python.org.
  218.  
  219. STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH
  220. REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
  221. MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH
  222. CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
  223. DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  224. PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  225. TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  226. PERFORMANCE OF THIS SOFTWARE.
  227.  
  228.