Debian Codegraph @

dist/Storable/README

raw
1 Storable 3.05c
2 Copyright (c) 1995-2000, Raphael Manfredi
3 Copyright (c) 2001-2004, Larry Wall
4 Copyright (c) 2016,2017 cPanel Inc
5
6 ------------------------------------------------------------------------
7 This program is free software; you can redistribute it and/or modify
8 it under the same terms as Perl 5 itself.
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 Perl 5 License schemes for more details.
14 ------------------------------------------------------------------------
15
16 +=======================================================================
17 | Storable is distributed as a module, but is also part of the official
18 | Perl core distribution, as of perl 5.8.
19 | Maintenance is partially done by the perl5-porters, and for cperl by cPanel.
20 | We thank Raphael Manfredi for providing us with this very useful module.
21 +=======================================================================
22
23 The Storable extension brings persistence to your data.
24
25 You may recursively store to disk any data structure, no matter how
26 complex and circular it is, provided it contains only SCALAR, ARRAY,
27 HASH (possibly tied) and references (possibly blessed) to those items.
28
29 At a later stage, or in another program, you may retrieve data from
30 the stored file and recreate the same hiearchy in memory. If you
31 had blessed references, the retrieved references are blessed into
32 the same package, so you must make sure you have access to the
33 same perl class than the one used to create the relevant objects.
34
35 There is also a dclone() routine which performs an optimized mirroring
36 of any data structure, preserving its topology.
37
38 Objects (blessed references) may also redefine the way storage and
39 retrieval is performed, and/or what deep cloning should do on those
40 objects.
41
42 To compile this extension, run:
43
44 perl Makefile.PL [PERL_SRC=...where you put perl sources...]
45 make
46 make install
47
48 There is an embedded POD manual page in Storable.pm.
49
50 Storable was written by Raphael Manfredi <[email protected]>
51 Maintenance is now done by cperl, https://github.com/rurban/Storable/
52 Note that p5p still ships an old broken version, without stack overflow
53 protection and large object support. As long as you don't store overlarge
54 objects, they are compatible.
55
56 Please e-mail us with problems, bug fixes, comments and complaints,
57 although if you have complements you should send them to Raphael.
58 Please don't e-mail Raphael with problems, as he no longer works on
59 Storable, and your message will be delayed while he forwards it to us.
60
61 ------------------------------------------------------------------------
62 Thanks to (in chronological order):
63
64 Jarkko Hietaniemi <[email protected]>
65 Ulrich Pfeifer <[email protected]>
66 Benjamin A. Holzman <[email protected]>
67 Andrew Ford <[email protected]>
68 Gisle Aas <[email protected]>
69 Jeff Gresham <[email protected]>
70 Murray Nesbitt <[email protected]>
71 Albert N. Micheev <[email protected]>
72 Marc Lehmann <[email protected]>
73 Justin Banks <[email protected]>
74 Jarkko Hietaniemi <[email protected]> (AGAIN, as perl 5.7.0 Pumpkin!)
75 Todd Rinaldo <[email protected]> and JD Lightsey <[email protected]>
76 for optional disabling tie and bless for increased security.
77 Reini Urban <[email protected]> for the 3.0x >2G support and rewrite
78 JD Lightsey <[email protected]>
79
80 for their contributions.
81
82 A Japanese translation of this man page is available at the Japanized
83 Perl Resources Project <https://sourceforge.jp/projects/perldocjp/>.
84 ------------------------------------------------------------------------
85
86 The perl5-porters would like to thank
87
88 Raphael Manfredi <[email protected]>
89
90 According to the perl5.8 Changes file, the following people have helped
91 bring you this Storable release:
92
93 Abhijit Menon-Sen <[email protected]>
94 Andreas J. Koenig <[email protected]>
95 Archer Sully <[email protected]>
96 Craig A. Berry <[email protected]>
97 Dan Kogai <[email protected]>
98 Doug MacEachern <[email protected]>
99 Gurusamy Sarathy <[email protected]>
100 H.Merijn Brand <[email protected]>
101 Jarkko Hietaniemi <[email protected]>
102 Mark Bixby
103 Michael Stevens <[email protected]>
104 Mike Guy <[email protected]>
105 Nicholas Clark <[email protected]>
106 Peter J. Farley III <[email protected]>
107 Peter Prymmer <[email protected]>
108 Philip Newton <[email protected]>
109 Raphael Manfredi <[email protected]>
110 Robin Barker <[email protected]>
111 Radu Greab <[email protected]>
112 Tim Bunce <[email protected]>
113 VMSperlers
114 Yitzchak Scott-Thoennes <[email protected]>