[MacPerl] Mac::Glue 19990531

[Chris Nandor <pudge@pobox.com>]

<URL:http://www.perl.com/CPAN/authors/id/CNANDOR/glue.19990531.tar.gz>

-----BEGIN PGP SIGNED MESSAGE-----

THIS IS ALPHA CODE AND IS SUBJECT TO CHANGE OR CRASH YOUR COMPUTER IN THE
MEANTIME.  I'm not just saying that, I mean it.

Note: gluenotes.pod is deprecated now.  All current documentation is
in this file and the Mac::Glue POD.

Please read this README.  Mac::Glue is not self-explanatory.  Some
assembly is required.


WHAT THIS IS
- ------------

It is an architecture for using Apple event terminology in MacPerl.
It is cool.
It is very unfinished.



GETTING STARTED
- ---------------

NOTE: some of the modules installed by cpan-mac and this distribution
might be older than versions you have installed (though in most
cases, that's unlikely).  If you install modules on your own often,
peruse the blib directory for modules you might not want to overwrite
ones you have installed.

Install the cpan-mac distribution (0.22 is the latest version) if you
haven't already.  In your Preferences, set site_perl as a libraries path
(so it will come before your main MacPerl lib directory).

Put the modules where they belong.  Everything need that doesn't come
with MacPerl or cpan-mac is here, including updated modules
Mac::AppleEvents::Simple, Mac::AppleEvents & Mac::Memory
(including shared libraries), Mac::AETE, and Mac::Glue itself.

For reference, Mac::Memory has a bug fixed in Handle::get, where a null
descriptor record would return garbled data.  Mac::AppleEvents has its
constants inlined, and has three functions added: AEPutKey, AEPutKeyDesc,
and AEGetKey.  See the POD in Mac::AppleEvents::Simple and Mac::Glue for
their changes.

The best way to install all this is with the installme program from
the cpan-mac distribution.  However, because we install our own new
ExtUtils::MM_MacOS and AutoSplit modules, you will need to run installme
on this distribution TWICE.  Kinda lame, but oh well.  cpan-mac can
be found at:

    http://www.perl.com/CPAN/authors/id/CNANDOR/

This will put everything in the right place, and autosplit where
necessary, and make life simple.  HOWEVER, you might want to back up
old modules and files that are being installed here, because the
existing files in the site_perl directory will be deleted if they exist.

This is not an official release of any of the extra modules included
with this distribution (like Mac::AppleEvents and Mac::AETE).

After installing, you need to run the gluedialect program and then the
gluescriptadds program.

WARNING: Storable seems unstable on CFM68K, and even some PPCs (I had
trouble on my iMac).  If you crash while running the gluedialect or
gluescriptadds programs, open the Mac::Glue module and change
$SERIALIZER to "FreezeThaw" instead of "Storable".  Then delete
everything in site_perl:Mac:Glues:glues: and start over, running
gluedialect and gluescriptadds again.

FreezeThaw seems to be significantly slower for our purposes, but it
will work.  The goal will be to fix Storable so it works more reliably
and use it for all systems, but for now, we'll supply FreezeThaw in
case Storable doesn't work for you.

Then, for each application you want to script, drop it on the gluemac
droplet.  Applications should not be running, in general, when dropped
on the droplet (though in some cases it will work anyway, and in some
cases the droplet will launch the application for you to get the needed
information).  First program you should drop on the droplet is probably
the Finder.  For each example script in this distribution you want to
try, run the applications through the droplet first.


PLAYING
- -------

Major changes to the interface since last release are that parameters
are no longer passed in a hashref, o() and p() are now obj() and prop()
again.  Lots of other stuff.  See the examples and read the Mac::Glue
POD.

Seems to be pretty stable so far.  Please play and read the notes
and feed back to macperl-modules (see http://www.macperl.org/
for more details).  Feel free to send any feedback, including
patched, to the list.

- --
Chris Nandor          mailto:pudge@pobox.com         http://pudge.net/
%PGPKey = ('B76E72AD', [1024, '0824090B CE73CA10  1FF77F13 8180B6B6'])

-----BEGIN PGP SIGNATURE-----
Version: PGPfreeware 5.0 for non-commercial use <http://www.pgp.com>
Charset: noconv

iQCVAwUBN1KUrChcZja3bnKtAQFPygP+LscryKFI0IHKQbWoAqsFyWkVe7Hd2QLX
J6s7JCVmGDj96Pff6a3KBD0lll5UBfnBZfalHXMBeF/VRwKCyJ5UaIUf7g4zP/+c
nLhjIq9J7hQhyFgxNfmGtqhbjBgrYuysufT45S1DXFC+rw5YYsqEa8E8iAB1PBRu
RYemtCt6F/0=
=hIup
-----END PGP SIGNATURE-----

===== Want to unsubscribe from this list?
===== Send mail with body "unsubscribe" to macperl-request@macperl.org