File: emacs-20.2-perlmacs-0.5.1.readme

##################################################################
###### CAUTION ###### CAUTION ###### CAUTION ###### CAUTION ######
##################################################################
#######                                                    #######
#######   THIS IS ALPHA SOFTWARE.  USE AT YOUR OWN RISK!   #######
#######   CONTAINS MANY KNOWN AND UNKNOWN BUGS!!!!!!!!!!!  #######
#######                                                    #######
##################################################################
###### CAUTION ###### CAUTION ###### CAUTION ###### CAUTION ######
##################################################################

WHAT
----
$CPAN/authors/id/JTOBEY/emacs-20.2-perlmacs-0.5.1.pl.gz, a patch for
GNU Emacs 20.2 to embed Perl.  Includes module "Emacs::Lisp".

WHY
---
The goal is to allow Emacs modules and customization code to be
written in Perl, as well as Emacs Lisp.  As of this ALPHA version,
crashes are frequent, and examples are lacking.

The task at hand is to discuss bugs, possible uses and interface
details.  Anyone want to set up a mailing list or newsgroup?  Please
email me if you would like to do this.

HOW
---
You must first install PERL VERSION 5.004 or higher.  I have done
minimal testing with the development Perl version 5.004_59, and
somewhat more with Perl 5.004_03.

Your perl must have working ExtUtils::Embed and ExtUtils::MakeMaker
capabilities.  If not, the configure script will exclude Perl support,
and you will have essentially standard GNU Emacs.

Retrieve and untar the Emacs distribution; for example:

   ftp://prep.ai.mit.edu/pub/gnu/emacs-20.2.tar.gz
   ftp://sunsite.unc.edu/pub/gnu/emacs-20.2.tar.gz

Retrieve the patch (see above).  Then do

   cd emacs-20.2
   gzip -dc ../emacs-20.2-perlmacs-0.3.pl.gz |perl
   ./configure
   make

and, if you're the adventurous type,

   make install

If you wish to use an installed version of perl other than the one
that's in your $PATH, set the environment variable $PERL to the
desired program when running configure.  For example, under bash or
sh:

   PERL=perl5.004 ./configure

Most of the documentation is in perl/Emacs-Lisp/Lisp.pm and should be
accessible after installation via

   perldoc Emacs::Lisp


CAVEAT
------
This is not meant to be tried on anything other than Unix-like
systems.  However, if you get it to work on non-unix, I would be
delighted to hear about it!

Cheers,
John
jtobey@channel1.com