Jack Jansen | 05249f96f | 1995-09-01 11:49:11 +0000 | [diff] [blame] | 1 | How to install Python 1.3beta3 on your Macintosh |
| 2 | ------------------------------------------------ |
| 3 | |
| 4 | Even if you don't usually read readme files: please read at least the |
| 5 | first sections of this file, failure to do so will probably result in |
| 6 | an unuseable python system. If this warning is too late and you already |
| 7 | have an non-functional python: it is best to remove all traces and start |
| 8 | with a fresh distribution. Especially don't forget to remove the |
| 9 | "python preferences" file from the Preferences folder, and possibly |
| 10 | "PythonCore" from the Extensions folder. |
| 11 | |
| 12 | Next: this is a beta distribution, so (a) things may be broken and (b) |
| 13 | the instructions are probably far from complete (or correct:-). I'm counting |
| 14 | on you to send me feedback on any problems you encounter or suggestions |
| 15 | you have! |
| 16 | |
| 17 | If this is your first encounter with python: you definitely need the common |
| 18 | user documentation (common to all platforms). You can find this (in various |
Jack Jansen | 59fcc5a | 1995-09-24 21:08:22 +0000 | [diff] [blame] | 19 | forms) on www.python.org and ftp.python.org. |
Jack Jansen | 05249f96f | 1995-09-01 11:49:11 +0000 | [diff] [blame] | 20 | |
| 21 | If you have a pre-system 7 macintosh: sorry, this release will not work |
| 22 | on your system. Too many sys7 features are used to make a sys6 python |
| 23 | easy to create. If you really want one: tell me, maybe I can be convinced. |
| 24 | Alternatively: get the sources, put in the necessary gestalt() and |
| 25 | compatability calls yourself and send me the results. |
| 26 | |
| 27 | If you don't have enough memory: the sizes choosen are somewhat arbitrary. |
| 28 | Try lowering them and seeing whether the resulting python is still usable. |
Jack Jansen | 8150760 | 1995-10-03 14:40:35 +0000 | [diff] [blame^] | 29 | Note, however, that python running out of memory may result in your mac |
| 30 | freezing. I don't fully understand yet why the mac freezes instead of doing |
| 31 | something a little less drastic. |
Jack Jansen | 05249f96f | 1995-09-01 11:49:11 +0000 | [diff] [blame] | 32 | |
| 33 | PowerPC Macintosh instructions |
| 34 | ------------------------------ |
| 35 | |
| 36 | 1. You will have to create some aliases in the 'PlugIns' folder. There is |
| 37 | an AppleScript there that will create them for you. If you don't have |
| 38 | AppleScript you will have to create the aliases by hand, read the script |
| 39 | to see what to do. Alternatively, if you have still have an older, but |
| 40 | fairly recent version of python already on your system: try the |
| 41 | MkPluginAliases script from the Scripts folder. |
| 42 | |
| 43 | [If someone nows of a way to create relative aliases or of a simple way |
| 44 | to create aliases on a target system without knowing pathnames in advance: |
| 45 | please let me know] |
| 46 | |
| 47 | 2. At this point you should remove older versions of "PythonCore" and |
| 48 | "Python Preferences" from your system folder. |
| 49 | |
| 50 | 3. Next, you should run PythonPPC. This will create an initial preferences |
| 51 | file (after asking you if that's ok with you). |
| 52 | |
| 53 | 4. To make sure any applets you create can find the common interpreter code |
Jack Jansen | 59fcc5a | 1995-09-24 21:08:22 +0000 | [diff] [blame] | 54 | you should move PythonCore to the Extensions folder (drop it on the |
| 55 | System Folder and it will find its own way). Alternatively, you can |
| 56 | make an alias called "PythonCore" in the Extensions folder and |
| 57 | point it to the real PythonCore. You may want to start PythonPPC |
| 58 | again at this point to check that you actually put the extension in |
| 59 | the right place. |
| 60 | |
Jack Jansen | 05249f96f | 1995-09-01 11:49:11 +0000 | [diff] [blame] | 61 | 5. You're all set now. Continue with the common instructions. |
| 62 | |
| 63 | 68K Macintosh instructions |
| 64 | -------------------------- |
| 65 | |
| 66 | 1. Remove old "Python Preferences" file from the Preferences folder, if you |
| 67 | have one (the file, that is, not the folder:-). |
| 68 | |
| 69 | 2. Run Python68K. This will create an initial preferences file (after |
| 70 | asking you if that's ok with you). |
| 71 | |
| 72 | 3. Continue with the next section. |
| 73 | |
| 74 | Common instructions |
| 75 | ------------------- |
| 76 | |
| 77 | You should now have a functioning python. It is probably a good idea to run |
| 78 | "testall.py" from :Lib:test at this point, this should not give any errors. |
Jack Jansen | 8150760 | 1995-10-03 14:40:35 +0000 | [diff] [blame^] | 79 | Running testall.py is done by double-clicking it or dropping it onto the |
| 80 | interpreter. |
Jack Jansen | 05249f96f | 1995-09-01 11:49:11 +0000 | [diff] [blame] | 81 | Next, try "compileall.py" from :Lib to create all .pyc files (but this isn't |
| 82 | really important). |
| 83 | |
| 84 | PPC users have a couple of applets in the main folder they may want to try, |
| 85 | (68K users can use the corresponding scripts from the "scripts" folder): |
| 86 | |
| 87 | - EditPythonPrefs allows you to edit the preferences file, to change the |
| 88 | python home folder or modify the initial sys.path setting. |
| 89 | - RunLibScript allows you to run any script as __main__ after setting arguments, |
| 90 | changing stdin/stdout/workdir, etc. |
| 91 | - For PPC only, mkapplet creates a python applet, a tiny application written |
| 92 | in python. Drop a python source on it and out comes the application. More |
| 93 | information can be found in the "Read me files" folder. |
| 94 | |
| 95 | PPC users will see one more files in the python folder: PythonApplet. This is |
| 96 | the template for building applets, leave it alone. |
| 97 | |
| 98 | Things to see |
| 99 | ------------- |
| 100 | |
| 101 | There are some readme files in the "Read me files" folder that may contain |
| 102 | useful information. Especially the Relnotes-1.3 file contains some interesting |
| 103 | tidbits. |
| 104 | |
| 105 | The "scripts" folder has some sample scripts. Some are useful, some are just |
| 106 | interesting to look at to see how various things work. The MkDistr, mkapplet |
| 107 | and fullbuild scripts (plus the ones mentioned above) may help you to understand |
| 108 | how to use AppleEvents and various other toolboxes from python. |
| 109 | |
| 110 | The Tools folder has all the (automatically generated) interfaces to toolboxes |
| 111 | available, and some simple test programs. See the scripts mentioned above for how |
| 112 | to use them. NOTE: the organization of the toolbox stuff is likely to change, |
| 113 | maybe even before the real 1.3 distribution. Until that time you will have to |
| 114 | use addpack or imp to import these files in your program. |
| 115 | |
| 116 | The 'img' group of modules, which handles I/O of many different image formats |
| 117 | (not pict yet, sigh:-) is included, but without documentation. You can find |
| 118 | docs at ftp://ftp.cwi.nl/pub/jack/python/img (or somewhere around there). |
| 119 | |
| 120 | Feedback |
| 121 | -------- |
| 122 | |
| 123 | Send bug reports, suggestions, contributions and fanmail to <jack@cwi.nl>. |
| 124 | Be warned however that I'm pretty busy at the moment, so I may not always |
| 125 | respond immedeately. |
| 126 | Alternatively, you can try sending to comp.lang.python or python-list@cwi.nl, |
| 127 | but since I read the newsgroup, not the mailinglist, I may miss it there |
| 128 | (but other people may know quite a bit more than me anyway:-). |
| 129 | |
| 130 | Jack Jansen |
| 131 | Centrum voor Wiskunde en Informatica |
| 132 | Kruislaan 413 |
| 133 | 1098 SJ Amsterdam |
| 134 | the Netherlands |
| 135 | |
| 136 | <jack@cwi.nl>, http://www.cwi.nl/~jack |