summaryrefslogtreecommitdiff
path: root/gnu/usr.bin/perl/ext/Storable/README
diff options
context:
space:
mode:
authorTodd C. Miller <millert@cvs.openbsd.org>2002-10-27 22:15:15 +0000
committerTodd C. Miller <millert@cvs.openbsd.org>2002-10-27 22:15:15 +0000
commit74cfb115ac810480c0000dc742b20383c1578bac (patch)
tree316d96e5123617976f1637b143570c309a662045 /gnu/usr.bin/perl/ext/Storable/README
parent453ade492b8e06c619009d6cd52a85cb04e8cf17 (diff)
stock perl 5.8.0 from CPAN
Diffstat (limited to 'gnu/usr.bin/perl/ext/Storable/README')
-rw-r--r--gnu/usr.bin/perl/ext/Storable/README110
1 files changed, 110 insertions, 0 deletions
diff --git a/gnu/usr.bin/perl/ext/Storable/README b/gnu/usr.bin/perl/ext/Storable/README
new file mode 100644
index 00000000000..2ed16d51da0
--- /dev/null
+++ b/gnu/usr.bin/perl/ext/Storable/README
@@ -0,0 +1,110 @@
+ Storable 1.015
+ Copyright (c) 1995-2000, Raphael Manfredi
+ Copyright (c) 2001,2002, Larry Wall
+
+------------------------------------------------------------------------
+ This program is free software; you can redistribute it and/or modify
+ it under the same terms as Perl 5 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. See the
+ Perl 5 License schemes for more details.
+------------------------------------------------------------------------
+
++=======================================================================
+| Storable is distributed as a module, but is also part of the official
+| Perl core distribution, as of perl 5.8.
+| Maintenance is now done by the perl5-porters. We thank Raphael
+| Manfredi for providing us with this very useful module.
++=======================================================================
+
+The Storable extension brings persistency to your data.
+
+You may recursively store to disk any data structure, no matter how
+complex and circular it is, provided it contains only SCALAR, ARRAY,
+HASH (possibly tied) and references (possibly blessed) to those items.
+
+At a later stage, or in another program, you may retrieve data from
+the stored file and recreate the same hiearchy in memory. If you
+had blessed references, the retrieved references are blessed into
+the same package, so you must make sure you have access to the
+same perl class than the one used to create the relevant objects.
+
+There is also a dclone() routine which performs an optimized mirroring
+of any data structure, preserving its topology.
+
+Objects (blessed references) may also redefine the way storage and
+retrieval is performed, and/or what deep cloning should do on those
+objects.
+
+To compile this extension, run:
+
+ perl Makefile.PL [PERL_SRC=...where you put perl sources...]
+ make
+ make install
+
+There is an embeded POD manual page in Storable.pm.
+
+Storable was written by Raphael Manfredi <Raphael_Manfredi@pobox.com>
+Maitainance is now done by the perl5-porters <perl5-porters@perl.org>
+
+Please e-mail us with problems, bug fixes, comments and complaints,
+although if you have complements you should send them to Raphael.
+Please don't e-mail Raphael with problems, as he no longer works on
+Storable, and your message will be delayed while he forwards it to us.
+
+------------------------------------------------------------------------
+Thanks to (in chronological order):
+
+ Jarkko Hietaniemi <jhi@iki.fi>
+ Ulrich Pfeifer <pfeifer@charly.informatik.uni-dortmund.de>
+ Benjamin A. Holzman <bah@ecnvantage.com>
+ Andrew Ford <A.Ford@ford-mason.co.uk>
+ Gisle Aas <gisle@aas.no>
+ Jeff Gresham <gresham_jeffrey@jpmorgan.com>
+ Murray Nesbitt <murray@activestate.com>
+ Albert N. Micheev <Albert.N.Micheev@f80.n5049.z2.fidonet.org>
+ Marc Lehmann <pcg@opengroup.org>
+ Justin Banks <justinb@wamnet.com>
+ Jarkko Hietaniemi <jhi@iki.fi> (AGAIN, as perl 5.7.0 Pumpkin!)
+
+for their contributions.
+
+There is a Japanese translation of this man page available at
+http://member.nifty.ne.jp/hippo2000/perltips/storable.htm,
+courtesy of Kawai, Takanori <kawai@nippon-rad.co.jp>.
+------------------------------------------------------------------------
+
+The perl5-porters would like to thank
+
+ Raphael Manfredi <Raphael_Manfredi@pobox.com>
+
+According to the perl5.8 Changes file, the following people have helped
+bring you this Storable release:
+
+ Abhijit Menon-Sen <ams@wiw.org>
+ Andreas J. Koenig <andreas.koenig@anima.de>
+ Archer Sully <archer@meer.net>
+ Craig A. Berry <craig.berry@psinetcs.com>
+ Dan Kogai <dankogai@dan.co.jp>
+ Doug MacEachern <dougm@covalent.net>
+ Gurusamy Sarathy <gsar@ActiveState.com>
+ H.Merijn Brand <h.m.brand@hccnet.nl>
+ Jarkko Hietaniemi <jhi@iki.fi>
+ Mark Bixby
+ Michael Stevens <michael@etla.org>
+ Mike Guy <mjtg@cam.ac.uk>
+ Nicholas Clark <nick@unfortu.net>
+ Peter J. Farley III <pjfarley@banet.net>
+ Peter Prymmer <pvhp@forte.com>
+ Philip Newton <pne@cpan.org>
+ Raphael Manfredi <Raphael_Manfredi@pobox.com>
+ Robin Barker <rmb1@cise.npl.co.uk>
+ Radu Greab <radu@netsoft.ro>
+ Tim Bunce <Tim.Bunce@pobox.com>
+ VMSperlers
+ Yitzchak Scott-Thoennes <sthoenna@efn.org>
+
+If I've missed you out, please accept my apologies, and e-mail your
+patch to perl5-porters@perl.org.