Perl-5.004_04.1.README
Mar 19, 1998

file:	Perl-5.004_04-1.PI.tar.gz
desc:	Framework port1 of perl v5.004_04
sum:	28504  3487
md5sum:	2d48f0958fe916aeee01535c36ed86f7

A complete Perl implementation built in the form of a Framework, so
that it can be used for embedding a perl interpreter into other products
(like apache + mod_perl). Install it only on computers running
Rhapsody DR1.

(***
 To go to:
 http://www.peak.org/ftp/pub/rhapsody/Developer/Frameworks/
 and/or ??
 http://www.peak.org/ftp/pub/rhapsody/Applications/Unix/perl/
***)

## INSTALLATION ##

Type in a Terminal.app window (as root).

> cd /wherever/the/file/is
> gnutar xvzf Perl-5.004_04-1.PI.bd.tar.gz
> installer.sh Perl.pkg

This will install the Perl.framework into /LocalLibrary/Frameworks.
If you want shell access to perl, you'll need to do one (or both) 
of the following:
1.  make symbolic link 
/usr/local/bin/perl 
pointing to
/LocalLibrary/Frameworks/Perl.framework/bin/perl

> cd /usr/local/bin
> ln -s /LocalLibrary/Frameworks/Perl.framework/bin/perl

2.  Add
/LocalLibrary/Frameworks/Perl.framework/bin
to your path.

This Perl framework has been built with the capability for setuid
perl scripts (ie, see Perl.framework/bin/suidperl), but it is not
enabled by default.  Set the above binary to be setuid root, if
this functionality is desired:

> cd /LocalLibrary/Frameworks/Perl.framework/bin
> chmod u+s suidperl5.00404 suidperl

This perl distribution installs for native build dynamic modules,
by default.  If you want your distribution to build FAT add-on
dynamically loadable modules, you'll need to look at
/LocalLibrary/Frameworks/Perl.framework/lib/rhapsody5/5.00404/Config.pm*.

A few perl modules require additional frameworks installed:
  GDBM_File -> GDBM.framework (>= 1.7.3.1)
  Compress::Zlib -> Zlib.framework ( >= 1.1.1.1)
These frameworks will be made available soon (if not already).


## RHAPSODY PORTING NOTES ##

- Used next_4.sh as skeleton for a rhapsody.sh hints file.
- Used dl_next.xs for dynamic loading.
- Add HAS_TELLDIR_PROTOTYPE to config.sh, config_h.SH 
  (fixes problem with pp_sys.c)
- Used system malloc.  I tried using perl's malloc, but had
  intermitent segmentation faults.
- modified perl.h and perl.c to use __environ for environment variable
  (like other systems).  David Young (dwy@ace.net) has an alternate 
  fix in his port of perl:
  - need to change dyld_stub_* in perl.c to the new _NSGetEnviron
  (much cooler if you ask me) in /usr/include/crt_externs.h
- Remove POSIX call to sigpending().  It is missing from System.framework, 
  though it IS documented.  I suspect this missing function to reappear
  in a later release of Rhapsody.


## PACKAGE NOTES ##

I cheated building this package.  The .tar.Z inside the pkg wrapper
is REALLY a .tar.gz archive, which makes this package much smaller.
The installer.sh doesn't mind, since it just pipes it to gzip and gnutar.


## CHANGELOG ##
 
Mar 18, 1998 (Framework port 1)
- First stab at framework, with perl5.004_04 (rhapsody5)
- I've abandoned (at least temporarily) the idea of the standard
  framework layout, with all files hiding down in Versions/5/,
  since this is painful to configure.  Since perl already handles
  multiple versions pretty well, I'll just build a pretty much
  standard perl with -prefix=/LocalLibrary/Frameworks/Perl.framework
- Changes from standard perl
  - prefix=/LocalLibrary/Frameworks/Perl.framework
  - remove perl5 from lib paths (redundant?)
  - platfrom/architecture = rhapsody5
  - patched Makefile.SH
    - recognize rhapsody5 as next4 (for libtool)
    - make Versions/5/Perl dylib,
        compatibility_version  04.00.00
        current_version        04.04.01 (Framework port1)
- updated all standard modules (as of 03/19/98 from CPAN), plus a few others:
  LWP, Apache::* (mod_perl).
- included suidperl, but it is not SETUID root, by default.
- perl modules that require additional frameworks installed:
  GDBM_File -> GDBM.framework (>= 1.7.3.1)
  Compress::Zlib -> Zlib.framework ( >= 1.1.1.1)

Mar  3, 1998 (port 2)
 - Add FAT binary (i386+ppc) support.  ppc untested.

Feb 23, 1998 (port 1)
 - First attempt, i386 only


CREDITS

Package Creation
Rex Dieter <rdieter@math.unl.edu>
Computer System Manager
University of Nebraska-Lincoln
Department of Mathematics and Statistics
http://www.math.unl.edu/~rdieter/

Perl home page
http://www.perl.com/