home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / C / Applications / MacPerl 5.1.3 / Mac_Perl_513_src / MacPerl5 / README.MAC < prev    next >
Encoding:
Text File  |  1997-01-21  |  12.4 KB  |  303 lines  |  [TEXT/McPL]
  1. WELCOME TO MACPERL 5
  2.  
  3. This is Perl 5, ported to the Mac by Matthias Neeracher <neeri@iis.ee.ethz.ch>
  4. Feel free to give this program away according to the terms stated 
  5. in the README file.
  6.  
  7. System Requirements
  8. -------------------
  9.  
  10. MacPerl5 requires System 7.
  11.  
  12. Online Help
  13. -----------
  14.  
  15. MacPerl 5 comes with a considerable amount of HTML based online help. For this
  16. help to work, make sure you have:
  17.  
  18.  - "MacPerl Help" and the "pod" folder in the same folder as your MacPerl
  19.    application.
  20.  - A recent version of Internet Config (preferably at least 1.2, which is
  21.    bundled with your distribution).
  22.  - Set up Internet Config with (Preferably identical) helpers for “http”
  23.    and “file”. 
  24.  
  25. Bugs, Suggestions, Damnations
  26. -----------------------------
  27.  
  28. Please send your bug reports and/or fixes to <neeri@iis.ee.ethz.ch> 
  29.  
  30. Mailing list
  31. ------------
  32.  
  33. There is a mailing list for announcing new releases, sharing scripts, and 
  34. discussions about how to make MacPerl change your life. To subscribe, send
  35. the following mail:
  36.  
  37. ----------------
  38. To: mac-perl-request@iis.ee.ethz.ch
  39.  
  40. subscribe
  41. ----------------
  42.  
  43. Ftp sites
  44. ---------
  45.  
  46. If you have internet access, you can obtain the newest versions of Perl by 
  47. anonymous ftp from one of the following address:
  48.  
  49. ftp.switch.ch [130.59.1.40]          software/mac/perl
  50.  
  51. This site is mirrored at
  52.  
  53. ftp.share.com      pub/macperl
  54. mors.gsfc.nasa.gov /pub/MacPerl/Applications
  55.  
  56. and in a huge number of CPAN (Common Perl Archive Network) mirror sites: 
  57.  
  58. North America
  59.  
  60. Florida 
  61.     ftp://ftp.cis.ufl.edu/pub/perl/CPAN/ports/mac/
  62. Illinois 
  63.     ftp://uiarchive.cso.uiuc.edu/pub/lang/perl/CPAN/ports/mac/ 
  64. Massachusetts 
  65.     ftp://ftp.delphi.com/pub/mirrors/packages/perl/CPAN/ports/mac/ 
  66. Oklahoma 
  67.     ftp://ftp.uoknor.edu/mirrors/CPAN/ports/mac/  
  68. Texas 
  69.     ftp://ftp.sedl.org/pub/mirrors/CPAN/ports/mac/  
  70.     ftp://ftp.sterling.com/programming/languages/perl/ports/mac/  
  71.  
  72. Europe
  73.  
  74. Finland 
  75.     ftp://ftp.funet.fi/pub/languages/perl/CPAN/ports/mac/ 
  76. France 
  77.     ftp://ftp.ibp.fr/pub/perl/CPAN/ports/mac/  
  78.     ftp://ftp.pasteur.fr/pub/computing/unix/perl/CPAN/ports/mac/  
  79. Germany 
  80.     ftp://ftp.leo.org/pub/comp/programming/languages/perl/CPAN/ports/mac/  
  81.     ftp://ftp.rz.ruhr-uni-bochum.de/pub/programming/languages/perl/CPAN/ports/mac/  
  82. Great Britain 
  83.     ftp://ftp.demon.co.uk/pub/mirrors/perl/CPAN/ports/mac/  
  84. The Netherlands 
  85.     ftp://ftp.cs.ruu.nl/pub/PERL/CPAN/ports/mac/  
  86. Portugal 
  87.     ftp://ftp.ci.uminho.pt/pub/lang/perl/ports/mac/  
  88. Sweden 
  89.     ftp://ftp.sunet.se/pub/lang/perl/CPAN/ports/mac/  
  90. Switzerland 
  91.     ftp://ftp.switch.ch/mirror/CPAN/ports/mac/  
  92.  
  93. Australasia
  94.  
  95. Australia 
  96.     ftp://coombs.anu.edu.au/pub/perl/ports/mac/  
  97.     ftp://ftp.mame.mu.oz.au/pub/perl/CPAN/ports/mac/  
  98. New Zealand 
  99.     ftp://ftp.tekotago.ac.nz/pub/perl/CPAN/ports/mac/  
  100.  
  101. Asia
  102.  
  103. Japan 
  104.     ftp://ftp.lab.kdd.co.jp/lang/perl/CPAN/ports/mac/  
  105. Taiwan 
  106.     ftp://dongpo.math.ncu.edu.tw/perl/CPAN/ports/mac/  
  107.  
  108. Africa
  109.  
  110. South Africa 
  111.     ftp://ftp.is.co.za/programming/perl/CPAN/ports/mac/  
  112.  
  113.  
  114. Matthias Neeracher                    Office:    +41 1 445 24 08
  115. Hohenklingenstrasse 19                Fax:        +41 1 445 24 24
  116. 8049 Zuerich                            Home:     +41 1 341 85 06
  117. SWITZERLAND                                Email:    <neeri@iis.ee.ethz.ch>
  118.  
  119. REVISION HISTORY
  120.  
  121. The person in [] is usually the key person to have convinced me to fix a 
  122. bug or add a feature. Everyone mentioned in [] should be mentioned in the
  123. MacPerl5 about box (Yes, your name could be there, too!).
  124.  
  125. 5.1.3r2    21Jan97
  126.  - Another attempt at runtime applications [Scott Weaver].
  127.  
  128. 5.1.2r2    19Jan97
  129.  - Choosing a file from one of the Apple Menu submenus under some 
  130.      versions of Apple Menu Options would crash [Kevin Cutts].
  131.  - Opening a file would crash under obscure circumstances
  132.      [Angus McIntyre].
  133.  - Socket.pm was broken in 5.1.1 [Paul Schinder].
  134.  - Removed debugging print statements in timelocal code [Paul Schinder].
  135.  - Added Speech Recognition support [Kenneth Albanowski].
  136.  - Added "MacPerl Scripts" folder whose items get added to script
  137.      menu.
  138.  - Fixed bug in GD [Ken Stuart].
  139.  - Fixed support for deferred scripts, so MacPerl scripts can
  140.      now queue successor scripts.
  141.  - Added "One Liner" script to simulate a command line. It even
  142.      does a bit of globbing [Devin Ben-Hur].
  143.  - Bundled CGI glue [as suggested by Peter Lewis].
  144.  
  145. 5.1.1r2    05Jan97
  146.  - MacPerl would silently overwrite locked files [Robert Decker].
  147.  - Saving runtime applications was broken.
  148.  - Converting a droplet to a plain text file was broken.
  149.  - Truncating the console din't work correctly [Alan Fry].
  150.  - Linking with libmoto for some performance improvement [William Middleton].
  151.  - Fixed numerous bugs in Mac::AppleEvents [Chris Nandor]. Rewrote
  152.      AEStreams interface OOP style.
  153.  - Added documentation for Mac::Files [William Birkett].
  154.  - Added some Alias Manager routines.
  155.  - Changed color of small icons so they can highlight when something is
  156.      dropped on them [Lasse Petersen].
  157.  - Added Macintsh specific (GUSI) consttants and packing to Sockets.
  158.  - Added Text-To-Speech support.
  159.  - Fine tuned cursor spinning.
  160.  - Improved error pop-up.
  161.  
  162. 5.1.0r2    21Oct96
  163.  - Upgraded the Perl core to patchlevel 5.002_01. This should cause several bugs
  164.    in the perl core to vanish.
  165.  - Made MakeMaker work on the Mac with lots of help and moral support from
  166.    Andreas König.
  167.  - Many toolbox modules now included. Added a few examples in :ext:
  168.  - Added "Shuck", a direct POD viewer, as a lightweight documentation
  169.    alternative to WWW browsers. To use it, open Internet Config and 
  170.     add "Shuck" as the helper for "pod".
  171.  - Tried fixing unsigned long problems with time values [Stewart Holt].
  172.  - Modified and unmodified scripts had different current directories for
  173.     "Run Front Window" [Matthias Schmitt].
  174.  - Stop hogging the preferences file, only open it when immediately 
  175.    needed [Toni Harbaugh]
  176.  - Fix MacPerl::Quit to work for fat runtimes. Also introduce symbolic¨
  177.    constants [Tom Holub].
  178.  - MacPerl::Ask() was broken when the user specified an empty string [Sam Choukri].
  179.  - Command-. for the 68K MPW tool was broken for a long time 
  180.    [Paul Patton, Chris Thorman].
  181.  - Horizontal scroll bar thumb actions were accidentally misinterpreted as 
  182.    vertical actions [Alan Fry].
  183.  - Fixed various problems with BBEdit interaction [Brian Foy]
  184.  - Fixed hardcoded chararacters in ftp.pl [Danny Thomas]
  185.  - Work around integerizing problem affecting Time::Local [Diller Ryan]
  186.  
  187. 5.0.7r1m 12Mar96
  188.  - Printing \007 to the MacPerl console window now causes a beep 
  189.    [Janis Greenberg].
  190.  - The jump command did not work for droplets.
  191.  - Runtimes were broken [lots of people, but I think it was Robert Coie who 
  192.    first did the research on what was causing the crashes].
  193.  - Some operations on bitvecs worked only the first time [reported by Paul Duda,
  194.    fixed by John Peterson]
  195.  - The MPW tool would crash on 68K machines [Guy Greenbaum]
  196.    
  197. 5.0.6r1m 01Feb96
  198.  - Redirecting STDIN would not work with <> [Jürgen Christoffel].
  199.  - After the first script execution, STDOUT would become unbuffered 
  200.    [Jeff Johnson].
  201.  - Perl would crash when running two CGI scripts in sequence (actually
  202.    a bug in the CGI glue) [Steve Goodwin].
  203.  - localtime, gmtime, and related routines and libraries exhibited various
  204.    problems [Peter Creath, Brad Cox, Dave Wodelet].
  205.  - Fixed a memory leak in sort [Vicki Brown].
  206.  - Performance in the background and for CGIs should be significantly improved.
  207.  - Performance for reads in raw mode massively improved [Dick Karpinski].
  208.  - Added a new interaction mode "Duplex" and tried to improve the documentation
  209.    of interaction modes in MacPerl.FrontEnd with actual AppleEvent logs.
  210.  - Implemented crypt(), which now makes MacPerl officially a munition.
  211.  - Cleaned up balloon help texts.
  212.  - "Check Syntax" now works analogously with "Run Script", i.e., both on the front
  213.    window and on a Standard file dialog [Angus McIntyre]
  214.  - The operations working on the "front window" have subtly redefined that term
  215.    to exclude console windows. This allows one to run a script again even if the
  216.     output window is in front [Anybody wanna take credit for that suggestion?].
  217.  - New environment variable "MACPERL" contains the path of the folder containing
  218.    the MacPerl application.
  219.  - Added a few automatic and semiautomatic ways to launch Internet Config. Among
  220.    other places, you now find IC in the Preferences dialog, and MacPerl suggests
  221.     that you launch IC if the file helper is missing.
  222.  
  223. 5.0.5r1m 29Dec95
  224.  - Fixed a disastrous bug with saving Droplets [Phil Ames]. The
  225.    MPW Tool has not changed except for the version number.
  226.  
  227. 5.0.4r1m 27Dec95
  228.  - Input for CGI POST requests didn't work [Christian Huldt, I think].
  229.  - Fixed various details in AppleEvent I/O streams, among them a very bad
  230.    bug with remote control mode.
  231.  - Removed edition manager support. I'm not sure if anyone was ever really
  232.    using it, and apparently it caused problems on some machines. 
  233.  - The long standing dependency on AppleScript should now a thing of the
  234.    past [Too many people to thank].
  235.  - Tried to improve sleep() behaviour [Paul Schinder].
  236.  - STDERR was overly buffered [Brad Cox].
  237.  - Copy & Paste had problems [Torsten Ekedahl].
  238.  - Created macperl.{pod,html} from MacPerl.Specifics.
  239.  - -w would give warnings about unused MacPerl::Version [Martin Heller].
  240.  - Some versions of system were buggy [Charles Bailey].
  241.  - Negative and big integers in MacPerl are very tricky. Fixed some bugs,
  242.    would like to hear if there are any more [Steve Bollinger].
  243.  - Verbose die()s would crash [Jon S. Stevens]
  244.  
  245. 5.0.3r1m 26Nov95
  246.  - When opening files, MacPerl 5.0.2r1m (and all earlier versions) calls
  247.     PrValidate without calling PrOpen first. This causes horrible crashes
  248.     when certain printers are selected, notably PDFWriter [Todd Hivnor].
  249.  - I was locking the text handle of the front window "forever" as soon as 
  250.    text was selected, which caused some operations to fail. This bug was
  251.     also in MacPerl4, but never seems to have been found [Stonewall Ballard].
  252.  - The MacPerl5 glue to choose() had a bug which caused PutFile to fail if a 
  253.    default was specified [Espen S. Ore].
  254.  - "-D" messages now go to the correct window, and you should no longer get
  255.    bogus malloc diagnostics on startup of a script [Martin Heller].
  256.  - Fixed an anachronism in perl5db.pl [Martin Heller].
  257.  - Calling -v twice in a row would crash [Phil Ames].
  258.  - Environment variables from the CGI glue would not be propagated correctly.
  259.  - The XL callback glue had a bug which would lead to unpredictable
  260.    results from XCMD calls [Jason Buberel].
  261.  - A change introduced in 5.0.1 was causing input from the console to
  262.    misbehave [Yuemo Zeng and Larry Allen-Tonar].
  263.  
  264. 5.0.2r1m 05Nov95
  265.  - Library paths got corrupted [Paul Schinder].
  266.  - A bug in the help code led to crashes with System error 11 on startup 
  267.      [Charles Albrecht and Richard Moe]. 
  268.  - After stopping a script with Command-., the next script would crash.
  269.  - A few items omitted from the 5.0.1 notes:
  270.      - readlink() no longer mounts network volumes. This has the disadvantage
  271.       that you can't necessarily expect the result to be open()able, but is 
  272.       probably more useful for checking scripts [Martin Heller].
  273.     - system now is implemented as print `xxx`, which is not quite correct
  274.       but covers the typical use of system().
  275.     - umask is "implemented", but simply does nothing.
  276.     - link is "implemented", but always fails.
  277.  
  278. 5.0.1r1m    31Oct95
  279.     I feel pretty good about this release:
  280.      -    Reliability should be considerably improved over 5.0.0
  281.      - The application features a new help system, based on suggestions by
  282.          Martin Heller. You need to install Internet Config 1.2 and then 
  283.         set up you favorite WWW browser as a helper entry for "file" for
  284.         the whole thing to work.
  285.      - Thanks to persistent lobbying by Dick Karpinski, the application now
  286.        supports raw keyboard input. Check out :t:mac:Raw.t for an example.
  287.      - The script menu now has an entry for syntax checking the front window,
  288.        for turning on the debugger and for turning on compilation warnings.
  289.         I believe that the new debugger interface will make it easier to debug
  290.         droplets and such.
  291.      - The a2p tool has been included and sort of works. 
  292.      - A source code release should appear within a week.
  293.      
  294. 5.0.0        25Aug95
  295.     This release is too good to delay and too bad to release. It had to go out
  296.     today as I'm leaving for holidays. In general, it seems to behave sensibly,
  297.     except for the application in out of memory situations. Don't run out of
  298.     memory. The library is mostly untested. 
  299.         Extra points for identifying all sounds in the about box and for finding 
  300.     the one feature that is missing in MacPerl4, although it could theoretically 
  301.     have been implemented there.
  302.  
  303.