diff options
author | Todd C. Miller <millert@cvs.openbsd.org> | 2002-10-27 22:15:15 +0000 |
---|---|---|
committer | Todd C. Miller <millert@cvs.openbsd.org> | 2002-10-27 22:15:15 +0000 |
commit | 74cfb115ac810480c0000dc742b20383c1578bac (patch) | |
tree | 316d96e5123617976f1637b143570c309a662045 /gnu/usr.bin/perl/ext/Storable/README | |
parent | 453ade492b8e06c619009d6cd52a85cb04e8cf17 (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/README | 110 |
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. |