home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 15 / AACD15.ISO / AACD / Programming / Python2 / Python20_source / README.AMIGA < prev    next >
Encoding:
Text File  |  2000-10-12  |  11.5 KB  |  310 lines
  1.  
  2. README text for the source code for Amiga Python 1.6
  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 'Python16'.
  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/Python16.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.
  84.  
  85.  
  86. 68000 or 68010 version
  87. ----------------------
  88.  
  89. AmigaPython doesn't run on a 68000 or 68010 CPU out-of-the-box.  You'll
  90. have to change compiler options to CPU=ANY and MATH=IEEE (instead of
  91. CPU=68030 and MATH=881).  BUT there is at least one other place I know of
  92. that requires additional changes to make it work:  the crc32 code in the
  93. Amiga directory.  You'll have to edit the SMAKEFILE in the Amiga directory
  94. and look for a comment "...change to M68000...".  Change the DEFINE on that
  95. line accordingly.  Otherwise the 68020+ version is assembled...  KRASH.
  96.  
  97. AmigaPython should run nicely out-of-the-box on a 68020 system provided it
  98. also has a FPU (68881/2).  I can't test this myself so please notify me if
  99. I'm wrong.
  100.  
  101.  
  102. Changing other compiler options
  103. -------------------------------
  104.  
  105. In the rare event that you would want to change compiler options and things
  106. like that, look in the following files:  SCOPTIONS, SMAKEFILE,
  107. include/config.h, include/config.c, include/osdefs.h.  If you change
  108. anything you'd better rebuild the thing from scratch.  (type 'smake clean'
  109. and then 'smake').
  110.  
  111.  
  112. Notes
  113. -----
  114.  
  115. Documentation and library files are NOT included.  Grab the distribution
  116. release from Aminet (dev/lang/Python.lha) to get them.  Only then you'll
  117. be able to actually do something with Python.
  118.  
  119. Ofcourse the main Python site (http://www.python.org/) is a vital source of
  120. information.
  121.  
  122. Some tests from the testset fail, others are skipped because they cannot
  123. run on the Amiga.  The crypt, grp, pwd, select and socket tests fail if
  124. bsdsocket.library (AmiTCP) or socket.library (I-Net 225) and/or
  125. usergroup.library cannot be opened.
  126.  
  127. Contact me for any information (irmen@bigfoot.com).
  128. My Amiga Python Homepage: http://www.bigfoot.com/~irmen/python.html
  129.  
  130.  
  131.  
  132. *** IMPORTANT ***
  133. -----------------
  134.  
  135. I don't fancy ten different versions of AmigaPython floating around.  So
  136. *please* if you made a change or enhancement or fix, contact me and if it's
  137. good it will be merged in the `official' AmigaPython version (mine).  That
  138. way, everyone can profit from it.  Thanks!
  139.  
  140.  
  141. *** THANKS ***
  142. --------------
  143.  
  144. Ofcourse this product could never have happened without the support of various
  145. people. Amongst others I'd like to thank:
  146.  
  147. Guido van Rossum - for creating Python in the first place
  148. Mike Meyer for his various suggestions and problem reports
  149. Kent Polk for his various suggestions and problem reports
  150. Lyster E. Wick for his various contributions (NewIcons/ARexx/WB/bugreports)
  151. Marc Christiansen for his detailed description of the strftime and
  152.   amiga.crc32 problems (and persuading me to fix them)
  153. Bablos to make me start polishing up the embedded python code.
  154. Adam Chodorowski for a few new doslib functions.
  155.  
  156. And ofcourse thanks to my friends who supported me in the first phase of
  157. this project and pushed me to continue this work (that was LONG ago, in the
  158. Python 1.2 days).
  159.  
  160. If you think your name is missing here, drop me a line!
  161.  
  162. To every AmigaPython user out there: thanks for your interest!
  163.  
  164.  
  165.  
  166.                     Irmen de Jong
  167.                     irmen@bigfoot.com
  168.                     October 1, 2000
  169.  
  170.  
  171.  
  172.  
  173.  
  174.     DISCLAIMER:
  175.  
  176. I  tried  to  make this program error-free and safe to use, for your and my
  177. own  benefit.   This  disclamer  applies  to the (small) part of the code I
  178. wrote  myself.   The  disclamer  from  the  copyright notice from Stichting
  179. Mathematisch  Centrum  (included  below)  applies  to the rest of the code,
  180. written by Guido van Rossum and others.
  181.   
  182. I  provide  this program "as is".  USE THE PROGRAM AT YOUR OWN RISK.  In no
  183. event will I be liable for damages to you - whether they arise from the use
  184. of  this  program  or  the  inability to use it, whether they are direct or
  185. consequential,  including,  but  not  limited  to,  the loss of data or the
  186. generation of inaccurate data.  No warranties are made.
  187.  
  188.  
  189.         Irmen de Jong.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.     PYTHON COPYRIGHT NOTICE AND LICENSE INFORMATION:
  196.     ------------------------------------------------
  197.  
  198.  
  199. A. HISTORY OF THE SOFTWARE
  200.  
  201. Python originated in 1991 at Stichting Mathematisch Centrum (CWI) in
  202. the Netherlands as an outgrowth of a language called ABC.  Its
  203. principal author was Guido van Rossum, although it included smaller
  204. contributions from others at CWI and elsewhere.  The last version of
  205. Python issued by CWI was Python 1.2.  In 1995, Mr. van Rossum
  206. continued his work on Python at the Corporation for National Research
  207. Initiatives (CNRI) in Reston, Virginia where several versions of the
  208. software were generated.  Python 1.6 is the last of the versions
  209. developed at CNRI.
  210.  
  211.  
  212.  
  213. B. TERMS AND CONDITIONS FOR ACCESSING OR OTHERWISE USING Python 1.6
  214.  
  215.  
  216. 1. CNRI OPEN SOURCE LICENSE AGREEMENT
  217.  
  218.  
  219. IMPORTANT: PLEASE READ THE FOLLOWING AGREEMENT CAREFULLY.
  220.  
  221. BY CLICKING ON "ACCEPT" WHERE INDICATED BELOW, OR BY COPYING,
  222. INSTALLING OR OTHERWISE USING PYTHON 1.6 SOFTWARE, YOU ARE DEEMED TO
  223. HAVE AGREED TO THE TERMS AND CONDITIONS OF THIS LICENSE AGREEMENT.
  224.  
  225. 1. This LICENSE AGREEMENT is between the Corporation for National
  226. Research Initiatives, having an office at 1895 Preston White Drive,
  227. Reston, VA 20191 ("CNRI"), and the Individual or Organization
  228. ("Licensee") accessing and otherwise using Python 1.6 software in
  229. source or binary form and its associated documentation, as released at
  230. the www.python.org Internet site on September 5, 2000 ("Python 1.6").
  231.  
  232. 2. Subject to the terms and conditions of this License Agreement, CNRI
  233. hereby grants Licensee a nonexclusive, royalty-free, world-wide
  234. license to reproduce, analyze, test, perform and/or display publicly,
  235. prepare derivative works, distribute, and otherwise use Python 1.6
  236. alone or in any derivative version, provided, however, that CNRI's
  237. License Agreement and CNRI's notice of copyright, i.e., "Copyright (c)
  238. 1995-2000 Corporation for National Research Initiatives; All Rights
  239. Reserved" are retained in Python 1.6 alone or in any derivative
  240. version prepared by Licensee.
  241.  
  242. Alternately, in lieu of CNRI's License Agreement, Licensee may
  243. substitute the following text (omitting the quotes): "Python 1.6 is
  244. made available subject to the terms and conditions in CNRI's License
  245. Agreement.  This Agreement together with Python 1.6 may be located on
  246. the Internet using the following unique, persistent identifier (known
  247. as a handle): 1895.22/1012.  This Agreement may also be obtained from a
  248. proxy server on the Internet using the following URL:
  249. http://hdl.handle.net/1895.22/1012".
  250.  
  251. 3. In the event Licensee prepares a derivative work that is based on
  252. or incorporates Python 1.6 or any part thereof, and wants to make the
  253. derivative work available to others as provided herein, then Licensee
  254. hereby agrees to include in any such work a brief summary of the
  255. changes made to Python 1.6.
  256.  
  257. 4. CNRI is making Python 1.6 available to Licensee on an "AS IS"
  258. basis.  CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
  259. IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND
  260. DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
  261. FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6 WILL NOT
  262. INFRINGE ANY THIRD PARTY RIGHTS.
  263.  
  264. 5. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
  265. 1.6 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A
  266. RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6, OR
  267. ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
  268.  
  269. 6. This License Agreement will automatically terminate upon a material
  270. breach of its terms and conditions.
  271.  
  272. 7. This License Agreement shall be governed by and interpreted in all
  273. respects by the law of the State of Virginia, excluding conflict of
  274. law provisions.  Nothing in this License Agreement shall be deemed to
  275. create any relationship of agency, partnership, or joint venture
  276. between CNRI and Licensee.  This License Agreement does not grant
  277. permission to use CNRI trademarks or trade name in a trademark sense
  278. to endorse or promote products or services of Licensee, or any third
  279. party.
  280.  
  281. 8. By clicking on the "ACCEPT" button where indicated, or by copying,
  282. installing or otherwise using Python 1.6, Licensee agrees to be bound
  283. by the terms and conditions of this License Agreement.
  284.  
  285.         ACCEPT
  286.  
  287.  
  288.  
  289. 2. CWI PERMISSIONS STATEMENT AND DISCLAIMER
  290.  
  291. Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam,
  292. The Netherlands.  All rights reserved.
  293.  
  294. Permission to use, copy, modify, and distribute this software and its
  295. documentation for any purpose and without fee is hereby granted,
  296. provided that the above copyright notice appear in all copies and that
  297. both that copyright notice and this permission notice appear in
  298. supporting documentation, and that the name of Stichting Mathematisch
  299. Centrum or CWI not be used in advertising or publicity pertaining to
  300. distribution of the software without specific, written prior
  301. permission.
  302.  
  303. STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
  304. THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
  305. FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
  306. FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  307. WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  308. ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
  309. OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  310.