README for Array::Autojoin
                                       Time-stamp: "2001-04-25 03:35:49 MDT"

                           Array::Autojoin

[Partially excerpted from the POD.]

NAME
    Array::Autojoin -- arrayrefs that stringify as join(", ", @$it)

SYNOPSIS
      use Array::Autojoin;
      my $headword = "biscocho";
      my $gloss = mkarray("cookie", "biscuit");
      print "$headword\: $gloss.\n";

       # Prints "biscocho: cookie, biscuit.\n";

DESCRIPTION
    This extremely short and simple module provides one exported
    function, mkpath( ...items... ), which makes an arrayref
    (containing those items) belonging to a class that does
    nothing other than specifying to Perl that when you want the
    string value of that arrayref, instead of giving something
    like "ARRAY(0x171568f)", it returns a happy string
    consisting of join(', ', @$arrayref).
[...]

COPYRIGHT
    Copyright 2001 Sean M. Burke.

    This library is free software; you can redistribute it
    and/or modify it under the same terms as Perl itself.

    This program is distributed in the hope that it will be
    useful, but without any warranty; without even the implied
    warranty of merchantability or fitness for a particular
    purpose.

AUTHOR
    Sean M. Burke, <[email protected]>


[End of POD excerpt]

PREREQUISITES

This suite requires Perl 5.006.  There seems to be a minor bug in
Perl 5.005 that makes boolean context not work right; if you don't
mind that, then you can use this module under Perl 5.005, I think.


INSTALLATION

You install Array::Autojoin, as you would install any perl module
library, by running these commands:

  perl Makefile.PL
  make
  make test
  make install

If you want to install a private copy of this suite in your home
directory, then you should try to produce the initial Makefile with
something like this command:

 perl Makefile.PL LIB=~/perl

Or see perldoc perlmodinstall


DOCUMENTATION

POD-format documentation is included in LAutojoin.pm.  POD is readable
with the 'perldoc' utility.  See ChangeLog for recent changes.


MACPERL INSTALLATION NOTES

You needn't bother with the makefiles.  Just make a Array directory
in your MacPerl site_lib or lib directory, and move Autojoin.pm into
there.


SUPPORT

Questions, bug reports, useful code bits, and suggestions for
Array::Autojoin should just be sent to me at [email protected]


AVAILABILITY

The latest version of Array::Autojoin is available from the
Comprehensive Perl Archive Network (CPAN).  Visit
<http://www.perl.com/CPAN/> to find a CPAN site near you.