home *** CD-ROM | disk | FTP | other *** search
/ Big Green CD 8 / BGCD_8_Dev.iso / Rhapsody / Frameworks / Perl-5.004_04.1-PI / Perl-5.004_04.1-PI.README
Encoding:
Text File  |  1998-04-25  |  4.3 KB  |  131 lines
  1. Perl-5.004_04.1.README
  2. Mar 19, 1998
  3.  
  4. file:    Perl-5.004_04-1.PI.tar.gz
  5. desc:    Framework port1 of perl v5.004_04
  6. sum:    28504  3487
  7. md5sum:    2d48f0958fe916aeee01535c36ed86f7
  8.  
  9. A complete Perl implementation built in the form of a Framework, so
  10. that it can be used for embedding a perl interpreter into other products
  11. (like apache + mod_perl). Install it only on computers running
  12. Rhapsody DR1.
  13.  
  14. (***
  15.  To go to:
  16.  http://www.peak.org/ftp/pub/rhapsody/Developer/Frameworks/
  17.  and/or ??
  18.  http://www.peak.org/ftp/pub/rhapsody/Applications/Unix/perl/
  19. ***)
  20.  
  21. ## INSTALLATION ##
  22.  
  23. Type in a Terminal.app window (as root).
  24.  
  25. > cd /wherever/the/file/is
  26. > gnutar xvzf Perl-5.004_04-1.PI.bd.tar.gz
  27. > installer.sh Perl.pkg
  28.  
  29. This will install the Perl.framework into /LocalLibrary/Frameworks.
  30. If you want shell access to perl, you'll need to do one (or both) 
  31. of the following:
  32. 1.  make symbolic link 
  33. /usr/local/bin/perl 
  34. pointing to
  35. /LocalLibrary/Frameworks/Perl.framework/bin/perl
  36.  
  37. > cd /usr/local/bin
  38. > ln -s /LocalLibrary/Frameworks/Perl.framework/bin/perl
  39.  
  40. 2.  Add
  41. /LocalLibrary/Frameworks/Perl.framework/bin
  42. to your path.
  43.  
  44. This Perl framework has been built with the capability for setuid
  45. perl scripts (ie, see Perl.framework/bin/suidperl), but it is not
  46. enabled by default.  Set the above binary to be setuid root, if
  47. this functionality is desired:
  48.  
  49. > cd /LocalLibrary/Frameworks/Perl.framework/bin
  50. > chmod u+s suidperl5.00404 suidperl
  51.  
  52. This perl distribution installs for native build dynamic modules,
  53. by default.  If you want your distribution to build FAT add-on
  54. dynamically loadable modules, you'll need to look at
  55. /LocalLibrary/Frameworks/Perl.framework/lib/rhapsody5/5.00404/Config.pm*.
  56.  
  57. A few perl modules require additional frameworks installed:
  58.   GDBM_File -> GDBM.framework (>= 1.7.3.1)
  59.   Compress::Zlib -> Zlib.framework ( >= 1.1.1.1)
  60. These frameworks will be made available soon (if not already).
  61.  
  62.  
  63. ## RHAPSODY PORTING NOTES ##
  64.  
  65. - Used next_4.sh as skeleton for a rhapsody.sh hints file.
  66. - Used dl_next.xs for dynamic loading.
  67. - Add HAS_TELLDIR_PROTOTYPE to config.sh, config_h.SH 
  68.   (fixes problem with pp_sys.c)
  69. - Used system malloc.  I tried using perl's malloc, but had
  70.   intermitent segmentation faults.
  71. - modified perl.h and perl.c to use __environ for environment variable
  72.   (like other systems).  David Young (dwy@ace.net) has an alternate 
  73.   fix in his port of perl:
  74.   - need to change dyld_stub_* in perl.c to the new _NSGetEnviron
  75.   (much cooler if you ask me) in /usr/include/crt_externs.h
  76. - Remove POSIX call to sigpending().  It is missing from System.framework, 
  77.   though it IS documented.  I suspect this missing function to reappear
  78.   in a later release of Rhapsody.
  79.  
  80.  
  81. ## PACKAGE NOTES ##
  82.  
  83. I cheated building this package.  The .tar.Z inside the pkg wrapper
  84. is REALLY a .tar.gz archive, which makes this package much smaller.
  85. The installer.sh doesn't mind, since it just pipes it to gzip and gnutar.
  86.  
  87.  
  88. ## CHANGELOG ##
  89.  
  90. Mar 18, 1998 (Framework port 1)
  91. - First stab at framework, with perl5.004_04 (rhapsody5)
  92. - I've abandoned (at least temporarily) the idea of the standard
  93.   framework layout, with all files hiding down in Versions/5/,
  94.   since this is painful to configure.  Since perl already handles
  95.   multiple versions pretty well, I'll just build a pretty much
  96.   standard perl with -prefix=/LocalLibrary/Frameworks/Perl.framework
  97. - Changes from standard perl
  98.   - prefix=/LocalLibrary/Frameworks/Perl.framework
  99.   - remove perl5 from lib paths (redundant?)
  100.   - platfrom/architecture = rhapsody5
  101.   - patched Makefile.SH
  102.     - recognize rhapsody5 as next4 (for libtool)
  103.     - make Versions/5/Perl dylib,
  104.         compatibility_version  04.00.00
  105.         current_version        04.04.01 (Framework port1)
  106. - updated all standard modules (as of 03/19/98 from CPAN), plus a few others:
  107.   LWP, Apache::* (mod_perl).
  108. - included suidperl, but it is not SETUID root, by default.
  109. - perl modules that require additional frameworks installed:
  110.   GDBM_File -> GDBM.framework (>= 1.7.3.1)
  111.   Compress::Zlib -> Zlib.framework ( >= 1.1.1.1)
  112.  
  113. Mar  3, 1998 (port 2)
  114.  - Add FAT binary (i386+ppc) support.  ppc untested.
  115.  
  116. Feb 23, 1998 (port 1)
  117.  - First attempt, i386 only
  118.  
  119.  
  120. CREDITS
  121.  
  122. Package Creation
  123. Rex Dieter <rdieter@math.unl.edu>
  124. Computer System Manager
  125. University of Nebraska-Lincoln
  126. Department of Mathematics and Statistics
  127. http://www.math.unl.edu/~rdieter/
  128.  
  129. Perl home page
  130. http://www.perl.com/
  131.