home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / python / !Python / !Help < prev    next >
Encoding:
Text File  |  1996-11-14  |  5.2 KB  |  146 lines
  1. Help file for !Python     -- RiscOS port v0.1 --
  2.  
  3. THIS SYSTEM REQUIRES RISCOS 3.1 OR LATER
  4.  
  5. IT IS SUPPLIED WITHOUT ANY FORM OF WARRANTY OR RESPONSIBILITY FOR ITS USE.
  6. See below for conditions.
  7.  
  8. This is a first attempt at a RiscOS port of the python interpreter.
  9. It is based on python v1.4
  10.  
  11. Python is copyright. See below for details.
  12.  
  13. ================================================================================
  14. Introduction
  15.  
  16. From the FAQ
  17.  
  18. 1.1. Q. What is Python?
  19.  
  20. A. Python is an interpreted, interactive, object-oriented programming
  21. language.  It incorporates modules, exceptions, dynamic typing, very
  22. high level dynamic data types, and classes.  Python combines
  23. remarkable power with very clear syntax.  It has interfaces to many
  24. system calls and libraries, as well as to various window systems, and
  25. is extensible in C or C++.  It is also usable as an extension language
  26. for applications that need a programmable interface.  Finally, Python
  27. is portable: it runs on many brands of UNIX, on the Mac, and on PCs
  28. under MS-DOS, Windows, Windows NT, and OS/2.
  29.  
  30. This RiscOS port contains most of the portable part of Python 1.4b2
  31. i.e. the parts common to Mac, Unix and MS-DOS.
  32.  
  33. It includes an interface to the RiscOS SWI calls, and an experimental
  34. interface to the toolbox modules.
  35.  
  36. Several example applications are provided.
  37.  
  38. You will need the toolbox modules to run these applications.
  39.  
  40. !Py_New     Create a new Python application framework.
  41. !Reporter   Wimp debugging tool.
  42. !Graph      Draw graphs using the drawfile module.
  43. !Ibrowse    Info browser.
  44.  
  45. Double clicking on the !Python icon should open a taskwindow running python.
  46.  
  47. A test of the interpreter can be run by double clicking on !Python.test.!Run 
  48.  
  49. There are some simple python example scripts in the directory scripts.
  50.  
  51. See http://www.python.org/ for the original source of Python, including parts
  52. that did not make the RiscOS port, and for user contributed examples.
  53.  
  54. ================================================================================
  55. Documentation
  56.  
  57. The Python FAQ can be found in !Python.Misc.FAQ.
  58.  
  59. The Python manuals in LaTeX or postscript form are supplied in the directory
  60. texdoc.
  61. A html translation of the library manual can be found in htmldoc.
  62.  
  63. A translation of the library manuals into texinfo info files can be found
  64. with the Python example info browser !Ibrowse.
  65.  
  66. The example applications each have help files.
  67.  
  68. ================================================================================
  69. Errors and omissions (Some of those I know about)
  70.  
  71. I have not yet obtained a filetype for Python scripts. If you want to use one
  72. of your own replace the files
  73.     !Python.!Boot, !Python.!Run, !Python.!Sprites and !Python.Sprites22
  74. by the versions in !Python.FileType . This will use a filetype of 0x38. You
  75. can change this by editing the !Boot and !Run files and renaming some sprites.
  76. The files in the scripts directory can then have their types set to Python.
  77.  
  78. The parser module is not included.
  79. The time.sleep function does not work.
  80. The os.environ array is not included.
  81.  
  82. Many things have not been checked thoroughly, in particular the socket related
  83. modules. Although I have managed to ftp something using Python, so some of it
  84. works.
  85.  
  86. The code in the riscospath module is a bit suspect. I am not quite sure what
  87. some of the RiscOS equivalents of the unix commands should be.
  88. In particular I have translated pythons .py and .pyc extensions to directories,
  89. the riscospath.splitext function does not cope with this.
  90.  
  91.  
  92. ================================================================================
  93. The source code
  94.  
  95. Python can be recreated from the source using the makefile provide. The
  96. makefile is for !AMU not !Make. You will need to edit the paths at the
  97. start of makefile.
  98.  
  99. The target "python" makes the interpreter itself.
  100. The target "alld" makes the dynamically linked modules.
  101. The default target "all" makes both.
  102.  
  103. This version was made using Acorn C v5.05 and OSLib v5.1. The socket module
  104. requires the Acorn socket library.
  105.  
  106. Dynamic linking is handled using my system dlk.
  107.  
  108. ================================================================================
  109. Changes from RiscOS release 0.0
  110.  
  111. A bug in dlk has been fixed so that dynamic linking should work with StrongArm.
  112. This release is based on Python 1.4 instead of 1.4b2.
  113.  
  114.  
  115. ================================================================================
  116. Copyright
  117.  
  118. The Python distribution is copyright.
  119. See the file !Python.Misc.COPYRIGHT for conditions.
  120.  
  121. The RISCOS changes and additions are copyright C.T.Stretch they may be used or
  122. distributed in any manner compatible with the Python copyright, provided
  123. that all copyright statements including this file remain intact.
  124.  
  125. ALL MATERIAL IN THIS DISTRIBUTION IS PROVIDED WITH NO WARRANTY WHATSOEVER
  126. USE IT AT YOUR OWN RISK
  127.  
  128. ================================================================================
  129. Contact
  130.  
  131. I would be pleased to hear bug reports or general comments about this port.
  132. I can be contacted at
  133.  
  134.            ct.stretch@ulst.ac.uk
  135.  
  136. or         C.T.Stretch,
  137.              Depatment of Mathematics,
  138.                University of Ulster,
  139.                  Coleraine Co. Londonderry,
  140.                    BT52 1SA
  141.                      NORTHERN IRELAND
  142.  
  143. New versions will be provided by electronic media only (probably HENSA).
  144.  
  145. Chris Stretch
  146.