This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[perl #118139] Storable 2.42 - die in global destruction
[perl5.git] / dist / Storable / ChangeLog
CommitLineData
f17010da
RU
1Thu May 23 09:59:33 CDT 2013 Reini Urban <rurban@cpanel.net>
2
3 Protect against SEGV during global destruction when used
4 in DESTROY blocks [perl #118139].
5 Compatibility fixes back to 5.6.
6
7Wed May 8 18:27:42 2013 -0600 Karl Williamson <public@khwilliamson.com>
8 Version 2.42
9
10 Remove core references to SVt_BIND (no changes)
11
12Sat Apr 13 17:45:10 2013 +0100 James E Keenan <jkeenan@cpan.org>
13 Version 2.41
14
15 Update INSTALLDIRS to favor installation under 'site'
16 (no changes)
17
18Fri Nov 30 23:03:09 2012 -0500 Steffen Mueller <smueller@cpan.org>
664f237a
SM
19 Version 2.40
20
21 Security warnings section added
22
6ac1779f 23Tue 11 Sep 06:51:11 IST 2012 Abhijit Menon-Sen <ams@toroid.org>
7a950fe4 24 Version 2.39
6ac1779f
AMS
25
26 Various bugfixes, including compatibility fixes for older
27 versions of Perl and vstring handling.
28
cefcbacf
AMS
29Sun 3 Jul 09:10:11 IST 2011 Abhijit Menon-Sen <ams@toroid.org>
30 Version 2.29
31
32 Various bugfixes, notably including preventing nfreeze from
33 incorrectly stringifying integers.
34
3139f421
DL
35Fri 3 Dec 14:12:32 GMT 2010 David Leadbeater <dgl@dgl.cx>
36 Version 2.25
37
38 Support for serializing coderefs containing UTF-8.
39
51f77169
AMS
40Fri Nov 12 10:52:19 IST 2010 Abhijit Menon-Sen <ams@toroid.org>
41
42 Version 2.24
43
44 Performance improvement for overloaded classes from Benjamin
45 Holzman.
46
47Fri Nov 12 10:36:22 IST 2010 Abhijit Menon-Sen <ams@toroid.org>
48
49 Version 2.23
50
51 Release the latest version from the Perl repository.
52
70006c44
SH
53Thu Aug 6 10:55:50 IST 2009 Abhijit Menon-Sen <ams@toroid.org>
54
55 Version 2.21
56
57 Includes hints/hpux.pl that was inadvertently left out of 2.20.
58
5c24ba53
AMS
59Mon May 18 09:38:20 IST 2009 Abhijit Menon-Sen <ams@toroid.org>
60
61 Version 2.20
62
63 Fix bug handling blessed references to overloaded objects, plus
64 other miscellaneous fixes.
65
66 (Version 2.19 was released with 5.8.9.)
67
8c68d109
AMS
68Thu Nov 22 13:24:18 IST 2007 Abhijit Menon-Sen <ams@toroid.org>
69
70 Version 2.18
71
72 Compile fixes for older Perls. (No functional changes.)
73
b90d408e
AMS
74Sat Nov 17 02:12:12 IST 2007 Abhijit Menon-Sen <ams@toroid.org>
75
76 Version 2.17
77
78 Various broken tests fixed. (No functional changes.)
79
c268aba5
RGS
80Sat Mar 31 06:11:06 IST 2007 Abhijit Menon-Sen <ams@toroid.org>
81
82 Version 2.16
83
84 1. Fixes to Storable::dclone, read_magic, retrieve_lscalar
85 2. Storable 0.1 compatibility
86 3. Miscellaneous compile/leak/test/portability fixes
87
0bb78401
AMS
88Mon May 23 22:48:49 IST 2005 Abhijit Menon-Sen <ams@wiw.org>
89
90 Version 2.15
91
92 Minor changes to address a couple of compile problems.
93
2f796f32 94Mon Apr 25 07:29:14 IST 2005 Abhijit Menon-Sen <ams@wiw.org>
c3c53033
NC
95
96 Version 2.14
97
98 1. Store weak references
2f796f32 99 2. Add STORABLE_attach hook.
c3c53033 100
fa523c3a
NC
101Thu Jun 17 12:26:43 BST 2004 Nicholas Clark <nick@ccl4.org>
102
103 Version 2.13
104
105 1. Don't change the type of top level overloaded references to RV -
106 they are perfectly correct as PVMG
107 2. Storable needs to cope with incoming frozen data that happens to be
108 utf8 encoded.
109
754c00ca
NC
110Wed Mar 17 15:40:29 GMT 2004 Nicholas Clark <nick@ccl4.org>
111
3f575d8d
NC
112 Version 2.12
113
754c00ca 114 1. Add regression tests for the auto-require of STORABLE_thaw
165cc789 115 2. Add auto-require of modules to restore overloading (and tests)
3f575d8d 116 3. Change to no context (should give speedup with ithreads)
754c00ca 117
dfd91409
NC
118Sat Mar 13 20:11:03 GMT 2004 Nicholas Clark <nick@ccl4.org>
119
120 Version 2.11
121
122 1. Storing restricted hashes in canonical order would SEGV. Fixed.
123 2. It was impossible to retrieve references to PL_sv_no and and
124 PL_sv_undef from STORABLE_thaw hooks.
125 3. restrict.t was failing on 5.8.0, due to 5.8.0's unique
126 implementation of restricted hashes using PL_sv_undef
127 4. These changes allow a space optimisation for restricted hashes.
128
a8b7ef86
AMS
129Sat Jan 24 16:22:32 IST 2004 Abhijit Menon-Sen <ams@wiw.org>
130
131 Version 2.10
132
133 1. Thread safety: Storable::CLONE/init_perlinterp() now create
134 a new Perl context for each new ithread.
135 (From Stas Bekman and Jan Dubois.)
136 2. Fix a tag count mismatch with $Storable::Deparse that caused
137 all back-references after a stored sub to be off-by-N (where
138 N was the number of code references in between).
139 (From Sam Vilain.)
140 3. Prevent CODE references from turning into SCALAR references.
141 (From Slaven Rezic.)
142
dcf2e277
NC
143Sat Jan 3 18:49:18 GMT 2004 Nicholas Clark <nick@ccl4.org>
144
145 Version 2.09
146
147 Fix minor problems with the CPAN release
7224c650 148 1: Make Storable.xs work on 5.8.2 and later (already in the core)
dcf2e277
NC
149 2: Ship the linux hints file
150 3: Ship Test::More for the benefit of Perls pre 5.6.2
7224c650 151 4: Correct Makefile.PL to only install in core for 5.8.0 and later
dcf2e277 152
fcaa57e7
AMS
153Sat Sep 6 01:08:20 IST 2003 Abhijit Menon-Sen <ams@wiw.org>
154
155 Version 2.08
156
157 This release works around a 5.8.0 bug which caused hashes to not
158 be marked as having key flags even though an HEK had HEK_WASUTF8
159 set. (Note that the only reasonable solution is to silently drop
160 the flag from the affected key.)
161
162 Users of RT 3 who were seeing assertion failures should upgrade.
163 (Perl 5.8.1 will have the bug fixed.)
164
a5271820
AMS
165Mon May 5 10:24:16 IST 2003 Abhijit Menon-Sen <ams@wiw.org>
166
167 Version 2.07
168
169 Minor bugfixes (self-tied objects are now correctly stored, as
170 are the results of additions larger than INT_MAX).
171
a2307be4
NC
172Mon Oct 7 21:56:38 BST 2002 Nicholas Clark <nick@ccl4.org>
173
174 Version 2.06
175
176 Remove qr// from t/downgrade.t so that it will run on 5.004
177 Mention $File::Spec::VERSION a second time in t/forgive.t so that it
178 runs without warnings in 5.004 (this may be a 5.00405 bug I'm working
179 round)
180 Fix t/integer.t initialisation to actually generate 64 bits of 9c
181 Fix comparison tests to use eval to get around 64 bit IV conversion
182 issues on 5.6.x, following my t/integer.t ^ precedence bug found by
183 Rafael Garcia-Suarez
184 Alter t/malice.t to work with Test/More.pm in t/, and skip individual
185 subtests that use $Config{ptrsize}, so that the rest of the test can
186 now be run with 5.004
187 Change t/malice.t and the error message in check_magic in Storable.xs
188 from "Pointer integer size" to "Pointer size"
189 Remove prerequisite of Test::More from Makefile.PL
190 Ship Test::Builder, Test::Simple and Test::More in t
191
9cfdba97
AMS
192Thu Oct 3 08:57:22 IST 2002 Abhijit Menon-Sen <ams@wiw.org>
193
194 Version 2.05
195
196 Adds support for CODE references from Slaven Rezic
197 <slaven.rezic@berlin.de>.
198
17374ab3
NC
199Fri Jun 7 23:55:41 BST 2002 Nicholas Clark
200
201 Version 2.04
202
203 Bug fix from Radu Greab <radu@netsoft.ro> (plus regression test)
204 to fix a recently introduced bug detected by Dave Rolsky.
205 Bug was that for a non threaded build, the class information was
206 being lost at freeze time on the first object with a STORABLE_freeze
207 hook. Consequentially the object was not blessed at all when thawed.
208 (The presence (or lack) of STORABLE_thaw was irrelevant; this was
209 a store-time data lost bug, caused by failure to initialize internal
210 context)
211 The bug was introduced as development perl change 16442 (on
212 2002/05/07), so has been present since 2.00.
213 Patches to introduce more regression tests to reduce the chance of
c4a6f826 214 a reoccurence of this sort of goof are always welcome.
17374ab3 215
ee0f7aac
NC
216Thu May 30 20:31:08 BST 2002 Nicholas Clark <nick@ccl4.org>
217
8932d55c
AMS
218 Version 2.03 Header changes on 5.6.x on Unix where IV is long long
219
220 5.6.x introduced the ability to have IVs as long long. However,
221 Configure still defined BYTEORDER based on the size of a long.
222 Storable uses the BYTEORDER value as part of the header, but
c4a6f826 223 doesn't explicitly store sizeof(IV) anywhere in the header.
8932d55c
AMS
224 Hence on 5.6.x built with IV as long long on a platform that
225 uses Configure (ie most things except VMS and Windows) headers
226 are identical for the different IV sizes, despite the files
227 containing some fields based on sizeof(IV)
228
229 5.8.0 is consistent; all platforms have BYTEORDER in config.h
230 based on sizeof(IV) rather than sizeof(long). This means that
231 the value of BYTEORDER will change from (say) 4321 to 87654321
232 between 5.6.1 and 5.8.0 built with the same options to Configure
233 on the same machine. This means that the Storable header will
234 differ, and the two versions will wrongly thing that they are
235 incompatible.
236
237 For the benefit of long term consistency, Storable now
238 implements the 5.8.0 BYTEORDER policy on 5.6.x. This means that
239 2.03 onwards default to be incompatible with 2.02 and earlier
240 (ie the large 1.0.x installed base) on the same 5.6.x perl.
241
242 To allow interworking, a new variable
243 $Storable::interwork_56_64bit is introduced. It defaults to
244 false. Set it to true to read and write old format files. Don't
245 use it unless you have existing stored data written with 5.6.x
246 that you couldn't otherwise read, or you need to interwork with
247 a machine running older Storable on a 5.6.x with long long IVs
248 (i.e., you probably don't need to use it).
249
2aeb6432
NC
250Sat May 25 22:38:39 BST 2002 Nicholas Clark <nick@ccl4.org>
251
25f64a11
AMS
252 Version 2.02
253
254 Rewrite Storable.xs so that the file header structure for write_magic
255 is built at compile time, and check_magic attempts to the header in
256 blocks rather than byte per byte. These changes make the compiled
257 extension 2.25% smaller, but are not significant enough to give a
258 noticeable speed up.
2aeb6432 259
db670f21
NC
260Thu May 23 22:50:41 BST 2002 Nicholas Clark <nick@ccl4.org>
261
25f64a11
AMS
262 Version 2.01
263
264 - New regression tests integer.t
265 - Add code to safely store large unsigned integers.
266 - Change code not to attempt to store large integers (ie > 32 bits)
267 in network order as 32 bits.
268
269 *Never* underestimate the value of a pathological test suite carefully
270 crafted with maximum malice before writing a line of real code. It
271 prevents crafty bugs from stowing away in your released code.
272 It's much less embarrassing to find them before you ship.
273 (Well, never underestimate it if you ever want to work for me)
274
8989364b
NC
275Fri May 17 22:48:59 BST 2002 Nicholas Clark <nick@ccl4.org>
276
25f64a11
AMS
277 Version 2.0, binary format 2.5 (but writes format 2.4 on pre 5.7.3)
278
279 The perl5 porters have decided to make sure that Storable still
280 builds on pre-5.8 perls, and make the 5.8 version available on CPAN.
281 The VERSION is now 2.0, and it passes all tests on 5.005_03, 5.6.1
282 and 5.6.1 with threads. On 5.6.0 t/downgrade.t fails tests 34 and 37,
283 due to a bug in 5.6.0 - upgrade to 5.6.1.
284
285 Jarkko and I have collated the list of changes the perl5 porters have
286 from the perl5 Changes file:
287
288 - data features of upcoming perl 5.8.0 are supported: Unicode hash
289 keys (Unicode hash values have been supported since Storable 1.0.1)
290 and "restricted hashes" (readonly hashes and hash entries)
291 - a newer version of perl can now be used to serialize data which is
292 not supported in earlier perls: Storable will attempt to do the
293 right thing for as long as possible, croaking only when safe data
294 conversion simply isn't possible. Alternatively earlier perls can
295 opt to have a lossy downgrade data instead of croaking
296 - when built with perls pre 5.7.3 this Storable writes out files
297 with binary format 2.4, the same format as Storable 1.0.8 onwards.
298 This should mean that this Storable will inter-operate seamlessly
299 with any Storable 1.0.8 or newer on perls pre 5.7.3
300 - dclone() now works with empty string scalar objects
301 - retrieving of large hashes is now more efficient
302 - more routines autosplit out of the main module, so Storable should
303 load slightly more quickly
304 - better documentation
305 - the internal context objects are now freed explicitly, rather than
306 relying on thread or process exit
307 - bugs fixed in debugging trace code affecting builds made with 64 bit
308 IVs
309 - code tidy-ups to allow clean compiles with more warning options
310 turned on avoid problems with $@ getting corrupted on 5.005_03 if
311 Carp wasn't already loaded
312 - added &show_file_magic, so you can add to /etc/magic and teach
313 Unix's file command about Storable files
314
315 We plan to keep Storable on CPAN in sync with the Perl core, so
316 if you encounter bugs or other problems building or using Storable,
317 please let us know at perl5-porters@perl.org
318 Patches welcome!
319
596596d5
JH
320Sat Dec 1 14:37:54 MET 2001 Raphael Manfredi <Raphael_Manfredi@pobox.com>
321
25f64a11
AMS
322 This is the LAST maintenance release of the Storable module.
323 Indeed, Storable is now part of perl 5.8, and will be maintained
324 as part of Perl. The CPAN module will remain available there
325 for people running pre-5.8 perls.
596596d5 326
25f64a11
AMS
327 Avoid requiring Fcntl upfront, useful to embedded runtimes.
328 Use an eval {} for testing, instead of making Storable.pm
329 simply fail its compilation in the BEGIN block.
596596d5 330
25f64a11 331 store_fd() will now correctly autoflush file if needed.
596596d5 332
6e0ac6f5
JH
333Tue Aug 28 23:53:20 MEST 2001 Raphael Manfredi <Raphael_Manfredi@pobox.com>
334
25f64a11
AMS
335 Fixed truncation race with lock_retrieve() in lock_store().
336 The file has to be truncated only once the exclusive lock is held.
6e0ac6f5 337
25f64a11 338 Removed spurious debugging messages in .xs file.
6e0ac6f5 339
e993d95c
JH
340Sun Jul 1 13:27:32 MEST 2001 Raphael Manfredi <Raphael_Manfredi@pobox.com>
341
25f64a11
AMS
342 Systematically use "=over 4" for POD linters.
343 Apparently, POD linters are much stricter than would
344 otherwise be needed, but that's OK.
e993d95c 345
25f64a11
AMS
346 Fixed memory corruption on croaks during thaw(). Thanks
347 to Claudio Garcia for reproducing this bug and providing the
348 code to exercise it. Added test cases for this bug, adapted
349 from Claudio's code.
e993d95c 350
25f64a11 351 Made code compile cleanly with -Wall (from Jarkko Hietaniemi).
e993d95c 352
25f64a11
AMS
353 Changed tagnum and classnum from I32 to IV in context. Also
354 from Jarkko.
e993d95c 355
8be2b38b
JH
356Thu Mar 15 01:22:32 MET 2001 Raphael Manfredi <Raphael_Manfredi@pobox.com>
357
25f64a11
AMS
358 Last version was wrongly compiling with assertions on, due
359 to an edit glitch. That did not cause any problem (apart from
360 a slight performance loss) excepted on Win* platforms, where the
361 assertion code does not compile.
8be2b38b
JH
362
363Sat Feb 17 13:37:37 MET 2001 Raphael Manfredi <Raphael_Manfredi@pobox.com>
364
25f64a11 365 Version 1.0.10.
8be2b38b 366
25f64a11
AMS
367 Forgot to increase version number at previous patch (there were
368 two of them, which is why we jump from 1.0.8 to 1.0.10).
8be2b38b 369
b12202d0
JH
370Sat Feb 17 13:35:00 MET 2001 Raphael Manfredi <Raphael_Manfredi@pobox.com>
371
25f64a11 372 Version 1.0.8, binary format 2.4.
b12202d0 373
25f64a11 374 Fixed incorrect error message.
b12202d0 375
25f64a11
AMS
376 Now bless objects ASAP at retrieve time, which is meant to fix
377 two bugs:
b12202d0 378
25f64a11
AMS
379 * Indirect references to overloaded object were not able to
380 restore overloading if the object was not blessed yet,
381 which was possible since blessing occurred only after the
382 recursive retrieval.
b12202d0 383
25f64a11
AMS
384 * Storable hooks asking for serialization of blessed ref could
385 get un-blessed refs at retrieval time, for the very same
386 reason.
b12202d0 387
25f64a11 388 The fix implemented here was suggested by Nick Ing-Simmons.
b12202d0 389
25f64a11
AMS
390 Added support for blessed ref to tied structures. This is the
391 cause for the binary format change.
b12202d0 392
25f64a11
AMS
393 Added EBCDIC version of the compatibility test with 0.6.11,
394 from Peter Prymmer
b12202d0 395
25f64a11
AMS
396 Added tests for the new features, and to make sure the bugs they
397 are meant to fix are indeed fixed.
b12202d0 398
862382c7
JH
399Wed Jan 3 10:43:18 MET 2001 Raphael Manfredi <Raphael_Manfredi@pobox.com>
400
25f64a11 401 Removed spurious 'clean' entry in Makefile.PL.
862382c7 402
25f64a11
AMS
403 Added CAN_FLOCK to determine whether we can flock() or not,
404 by inspecting Perl's configuration parameters, as determined
405 by Configure.
862382c7 406
25f64a11
AMS
407 Trace offending package when overloading cannot be restored
408 on a scalar.
862382c7 409
25f64a11
AMS
410 Made context cleanup safer to avoid dup freeing, mostly in the
411 presence of repeated exceptions during store/retrieve (which can
412 cause memory leaks anyway, so it's just additional safety, not a
413 definite fix).
862382c7 414
90826881
JH
415Sun Nov 5 18:23:48 MET 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
416
25f64a11 417 Version 1.0.6.
90826881 418
25f64a11
AMS
419 Fixed severe "object lost" bug for STORABLE_freeze returns,
420 when refs to lexicals, taken within the hook, were to be
421 serialized by Storable. Enhanced the t/recurse.t test to
422 stress hook a little more with refs to lexicals.
90826881 423
212e9bde
JH
424Thu Oct 26 19:14:38 MEST 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
425
25f64a11 426 Version 1.0.5.
212e9bde 427
25f64a11
AMS
428 Documented that store() and retrieve() can return undef.
429 That is, the error reporting is not always made via exceptions,
430 as the paragraph on error reporting was implying.
212e9bde 431
25f64a11
AMS
432 Auto requires module of blessed ref when STORABLE_thaw misses.
433 When the Storable engine looks for the STORABLE_thaw hook and
434 does not find it, it now tries to require the package into which
435 the blessed reference is.
212e9bde 436
25f64a11
AMS
437 Just check $^O, in t/lock.t: there's no need to pull the whole
438 Config module for that.
212e9bde 439
8be2b38b
JH
440Mon Oct 23 20:03:49 MEST 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
441
25f64a11 442 Version 1.0.4.
8be2b38b 443
25f64a11
AMS
444 Protected calls to flock() for DOS platform: apparently, the
445 flock/fcnlt emulation is reported to be broken on that
446 platform.
8be2b38b 447
25f64a11
AMS
448 Added logcarp emulation if they don't have Log::Agent, since
449 we now use it to carp when lock_store/lock_retrieve is used
450 on DOS.
8be2b38b 451
dd19458b
JH
452Fri Sep 29 21:52:29 MEST 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
453
25f64a11 454 Version 1.0.3.
dd19458b 455
25f64a11
AMS
456 Avoid using "tainted" and "dirty" since Perl remaps them via
457 cpp (i.e. #define). This is deeply harmful when threading
458 is enabled. This concerned both the context structure and
459 local variable and argument names. Brrr..., scary!
dd19458b
JH
460
461Thu Sep 28 23:46:39 MEST 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
462
25f64a11 463 Version 1.0.2.
dd19458b 464
25f64a11 465 Fixed spelling in README.
dd19458b 466
25f64a11
AMS
467 Added lock_store, lock_nstore, and lock_retrieve (advisory locking)
468 after a proposal from Erik Haugan <erik@solbors.no>.
dd19458b 469
25f64a11 470 Perls before 5.004_04 lack newSVpvn, added remapping in XS.
dd19458b 471
25f64a11 472 Fixed stupid typo in the t/utf8.t test.
dd19458b
JH
473
474Sun Sep 17 18:51:10 MEST 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
475
25f64a11 476 Version 1.0.1, binary format 2.3.
dd19458b 477
25f64a11 478 Documented that doubles are stored stringified by nstore().
dd19458b 479
25f64a11
AMS
480 Added Salvador Ortiz Garcia in CREDITS section, He identified
481 a bug in the store hooks and proposed the right fix: the class
482 id was allocated too soon. His bug case was also added to
483 the regression test suite.
dd19458b 484
25f64a11
AMS
485 Now only taint retrieved data when source was tainted. A bug
486 discovered by Marc Lehmann.
dd19458b 487
25f64a11
AMS
488 Added support for UTF-8 strings, a contribution of Marc Lehmann.
489 This is normally only activated in post-5.6 perls.
dd19458b 490
9e21b3d0
JH
491Thu Aug 31 23:06:06 MEST 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
492
25f64a11
AMS
493 First official release Storable 1.0, for inclusion in perl 5.7.0.
494 The license scheme is now compatible with Perl's.
9e21b3d0 495
f0ffaed8
JH
496Thu Aug 24 01:02:02 MEST 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
497
25f64a11
AMS
498 ANSI-fied most of the code, preparing for Perl core integration.
499 The next version of Storable will be 0.8, and will be integrated
500 into the Perl core (development branch).
f0ffaed8 501
25f64a11
AMS
502 Dispatch tables were moved upfront to relieve some compilers,
503 especially on AIX and Windows platforms.
f0ffaed8 504
25f64a11 505 Merged 64-bit fixes from perl5-porters.
f0ffaed8 506
7a6a85bf
RG
507Mon Aug 14 09:22:04 MEST 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
508
25f64a11
AMS
509 Added a refcnt dec in retrieve_tied_key(): sv_magic() increases
510 the refcnt on the mg_ptr as well.
7a6a85bf 511
25f64a11
AMS
512 Removed spurious dependency to Devel::Peek, which was used for
513 testing only in t/tied_items.t. Thanks to Conrad Heiney
514 <conrad@fringehead.org> for spotting it first.
7a6a85bf
RG
515
516Sun Aug 13 22:12:59 MEST 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
517
25f64a11
AMS
518 Marc Lehmann kindly contributed code to add overloading support
519 and to handle references to tied variables.
7a6a85bf 520
25f64a11
AMS
521 Rewrote leading blurb about compatibility to make it clearer what
522 "backward compatibility" is about: when I say 0.7 is backward
523 compatible with 0.6, it means the revision 0.7 can read files
524 produced by 0.6.
7a6a85bf 525
25f64a11 526 Mention new Clone(3) extension in SEE ALSO.
7a6a85bf 527
25f64a11
AMS
528 Was wrongly optimizing for "undef" values in hashes by not
529 fully recursing: as a result, tied "undef" values were incorrectly
530 serialized.
7a6a85bf
RG
531
532Sun Jul 30 12:59:17 MEST 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
533
25f64a11 534 First revision of Storable 0.7.
7a6a85bf 535
25f64a11
AMS
536 The serializing format is new, known as version 2.0. It is fully
537 backward compatible with 0.6. Earlier formats are deprecated and
538 have not even been tested: next version will drop pre-0.6 format.
7a6a85bf 539
25f64a11 540 Changes since 0.6@11:
7a6a85bf 541
25f64a11
AMS
542 - Moved interface to the "beta" status. Some tiny parts are still
543 subject to change, but nothing important enough to warrant an "alpha"
544 status any longer.
7a6a85bf 545
25f64a11
AMS
546 - Slightly reduced the size of the Storable image by factorizing
547 object class names and removing final object storage notification due
548 to a redesign of the blessed object storing.
7a6a85bf 549
25f64a11
AMS
550 - Classes can now redefine how they wish their instances to be serialized
551 and/or deep cloned. Serializing hooks are written in Perl code.
7a6a85bf 552
25f64a11 553 - The engine is now fully re-entrant.
7a6a85bf
RG
554
555Sun Apr 2 23:47:50 MEST 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
556
25f64a11
AMS
557 Added provision to detect more recent binary formats, since
558 the new upcoming Storable-0.7 will use a different format.
559 In order to prevent attempting the de-serialization of newer
560 formats by older versions, I'm adding this now to the 0.6 series.
7a6a85bf 561
25f64a11
AMS
562 I'm expecting this revision to be the last of the 0.6 series.
563 Unless it does not work with perl 5.6, which I don't use yet,
564 and therefore against which I cannot test.
7a6a85bf
RG
565
566Wed Mar 29 19:55:21 MEST 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
567
25f64a11
AMS
568 Added note about format incompatibilities with old versions
569 (i.e. pre 0.5@9 formats, which cannot be understood as there
570 was no versionning information in the file by then).
7a6a85bf 571
25f64a11
AMS
572 Protect all $@ variables when eval {} used, to avoid corrupting
573 it when store/retrieve is called within an exception handler.
7a6a85bf 574
25f64a11
AMS
575 Mistakenly included "patchlevel.h" instead of <patchlevel.h>,
576 preventing Perl's patchlevel from being included, which is
577 needed starting from 5.6.
7a6a85bf
RG
578
579Tue May 12 09:15:15 METDST 1998 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
580
25f64a11
AMS
581 Fixed shared "undef" bug in hashes, which did not remain shared
582 through store/retrieve.
7a6a85bf
RG
583
584Thu Feb 10 19:48:16 MET 2000 Raphael Manfredi <Raphael_Manfredi@pobox.com>
585
25f64a11
AMS
586 added last_op_in_netorder() predicate
587 documented last_op_in_netorder()
588 added tests for the new last_op_in_netorder() predicate
7a6a85bf
RG
589
590Wed Oct 20 19:07:36 MEST 1999 Raphael Manfredi <Raphael_Manfredi@pobox.com>
591
25f64a11 592 Forgot to update VERSION
7a6a85bf
RG
593
594Tue Oct 19 21:25:02 MEST 1999 Raphael Manfredi <Raphael_Manfredi@pobox.com>
595
25f64a11 596 Added mention of japanese translation for the manual page.
7a6a85bf 597
25f64a11
AMS
598 Fixed typo in macro that made threaded code not compilable,
599 especially on Win32 platforms.
7a6a85bf 600
25f64a11
AMS
601 Changed detection of older perls (pre-5.005) by testing PATCHLEVEL
602 directly instead of relying on internal symbols.
7a6a85bf
RG
603
604Tue Sep 14 22:13:28 MEST 1999 Raphael Manfredi <Raphael_Manfredi@pobox.com>
605
25f64a11
AMS
606 Integrated "thread-safe" patch from Murray Nesbitt.
607 Note that this may not be very efficient for threaded code,
608 see comment in the code.
7a6a85bf 609
25f64a11
AMS
610 Try to avoid compilation warning on 64-bit CPUs. Can't test it,
611 since I don't have access to such machines.
7a6a85bf
RG
612
613Mon Jul 12 14:37:19 METDST 1999 Raphael Manfredi <Raphael_Manfredi@pobox.com>
614
25f64a11 615 changed my e-mail to pobox.
7a6a85bf 616
c4a6f826 617 mentioned it is not thread-safe.
7a6a85bf 618
25f64a11 619 updated version number.
7a6a85bf 620
25f64a11 621 uses new internal PL_* naming convention.
7a6a85bf
RG
622
623Fri Jul 3 13:38:16 METDST 1998 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
624
25f64a11
AMS
625 Updated benchmark figures due to recent optimizations done in
626 store(): tagnums are now stored as-is in the hash table, so
627 no surrounding SV is created. And the "shared keys" mode for
628 hash table was turned off.
7a6a85bf 629
25f64a11
AMS
630 Fixed backward compatibility (wrt 0.5@9) for retrieval of
631 blessed refs. That old version did something wrong, but the
632 bugfix prevented correct retrieval of the old format.
7a6a85bf
RG
633
634Mon Jun 22 11:00:48 METDST 1998 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
635
25f64a11 636 Changed benchmark figures.
7a6a85bf 637
25f64a11
AMS
638 Adjust refcnt of tied objects after calling sv_magic() to avoid
639 memory leaks. Contributed by Jeff Gresham.
7a6a85bf
RG
640
641Fri Jun 12 11:50:04 METDST 1998 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
642
25f64a11
AMS
643 Added workaround for persistent LVALUE-ness in perl5.004. All
644 scalars tagged as being an lvalue are handled as if they were
645 not an lvalue at all. Added test for that LVALUE bug workaround.
7a6a85bf 646
c4a6f826
PAR
647 Now handles Perl immortal scalars explicitly, by storing &sv_yes
648 as such, explicitly.
7a6a85bf 649
25f64a11
AMS
650 Retrieval of non-immortal undef cannot be shared. Previous
651 version was over-optimizing by not creating a separate SV for
652 all undefined scalars seen.
7a6a85bf
RG
653
654Thu Jun 4 17:21:51 METDST 1998 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
655
25f64a11 656 Baseline for Storable-0.6@0.
7a6a85bf 657
25f64a11
AMS
658 This version introduces a binary incompatibility in the generated
659 binary image, which is more compact than older ones by approximatively
660 15%, depending on the exact degree of sharing in your structures.
7a6a85bf 661
25f64a11
AMS
662 The good news is that your older images can still be retrieved with
663 this version, i.e. backward compatibility is preserved. This version
664 of Storable can only generate new binaries however.
7a6a85bf 665
25f64a11
AMS
666 Another good news is that the retrieval of data structure is
667 significantly quicker than before, because a Perl array is used
668 instead of a hash table to keep track of retrieved objects, and
669 also because the image being smaller, less I/O function calls are
670 made.
7a6a85bf
RG
671
672Tue May 12 09:15:15 METDST 1998 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
673
25f64a11 674 Version number now got from Storable.pm directly.
7a6a85bf 675
25f64a11
AMS
676 Fixed overzealous sv_type() optimization, which would make
677 Storable fail when faced with an "upgraded" SV to the PVIV
678 or PVNV kind containing a reference.
7a6a85bf
RG
679
680Thu Apr 30 15:11:30 METDST 1998 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
681
25f64a11
AMS
682 Extended the SYNOPSIS section to give quick overview of the
683 routines and their signature.
7a6a85bf 684
25f64a11
AMS
685 Optimized sv_type() to avoid flags checking when not needed, i.e.
686 when their type makes it impossible for them to be refs or tied.
687 This slightly increases throughput by a few percents when refs
688 and tied variables are marginal occurrences in your data.
7a6a85bf 689
25f64a11
AMS
690 Stubs for XS now use OutputStream and InputStream file types to
691 make it work when the given file is actually a socket. Perl
692 makes a distinction for sockets in its internal I/O structures
693 by having both a read and a write structure, whereas plain files
694 share the same one.
7a6a85bf
RG
695
696Tue Jun 3 09:41:33 METDST 1997 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
697
25f64a11
AMS
698 Thanks to a contribution from Benjamin A. Holzman, Storable is now
699 able to correctly serialize tied SVs, i.e. tied arrays, hashes
700 and scalars.
7a6a85bf
RG
701
702Thu Apr 9 18:07:51 METDST 1998 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
703
25f64a11 704 I said SvPOK() had changed to SvPOKp(), but that was a lie...
7a6a85bf
RG
705
706Wed Apr 8 13:14:29 METDST 1998 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
707
25f64a11
AMS
708 Wrote sizeof(SV *) instead of sizeof(I32) when portable, which
709 in effect mangled the object tags and prevented portability
c4a6f826 710 across 32/64 bit architectures!
7a6a85bf
RG
711
712Wed Mar 25 14:57:02 MET 1998 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
713
25f64a11
AMS
714 Added code example for store_fd() and retrieve_fd() in the
715 man page, to emphasize that file descriptors must be passed as
716 globs, not as plain strings.
7a6a85bf 717
25f64a11
AMS
718 Cannot use SV addresses as tag when using nstore() on LP64. This
719 was the cause of problems when creating a storable image on an
720 LP64 machine and retrieving it on an ILP32 system, which is
721 exactly what nstore() is meant for...
7a6a85bf 722
25f64a11 723 However, we continue to use SV addresses as tags for plain store(),
c4a6f826 724 because benchmarking shows that it saves up to 8% of the store
25f64a11
AMS
725 time, and store() is meant to be fast at the expense of lack
726 of portability.
7a6a85bf 727
25f64a11
AMS
728 This means there will be approximately an 8% degradation of
729 performance for nstore(), but it's now working as expected.
730 That cost may vary on your machine of course, since it is
731 solely caused by the memory allocation overhead used to create
732 unique SV tags for each distinct stored SV.
7a6a85bf
RG
733
734Tue Jan 20 09:21:53 MET 1998 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
735
25f64a11 736 Don't use any '_' in version number.
7a6a85bf
RG
737
738Tue Jan 13 17:51:50 MET 1998 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
739
25f64a11 740 Updated version number.
7a6a85bf 741
25f64a11 742 added binmode() calls for systems where it matters.
7a6a85bf 743
25f64a11
AMS
744 Be sure to pass globs, not plain file strings, to C routines,
745 so that Storable can be used under the Perl debugger.
7a6a85bf
RG
746
747Wed Nov 5 10:53:22 MET 1997 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
748
25f64a11 749 Fix memory leaks on seen hash table and returned SV refs.
7a6a85bf 750
25f64a11 751 Storable did not work properly when tainting enabled.
7a6a85bf 752
25f64a11
AMS
753 Fixed "Allocation too large" messages in freeze/thaw and added.
754 proper regression test in t/freeze.t.
7a6a85bf
RG
755
756Tue Jun 3 09:41:33 METDST 1997 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
757
25f64a11 758 Updated version number
7a6a85bf 759
25f64a11 760 Added freeze/thaw interface and dclone.
7a6a85bf
RG
761
762Fri May 16 10:45:47 METDST 1997 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
763
25f64a11
AMS
764 Forgot that AutoLoader does not export its own AUTOLOAD.
765 I could use
7a6a85bf 766
25f64a11
AMS
767 use AutoLoader 'AUTOLOAD';
768
769 but that would not be backward compatible. So the export is
770 done by hand...
7a6a85bf
RG
771
772Tue Mar 25 11:21:32 MET 1997 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
773
25f64a11 774 Empty scalar strings are now "defined" at retrieval time.
7a6a85bf 775
25f64a11 776 New test to ensure an empty string is defined when retrieved.
7a6a85bf
RG
777
778Thu Feb 27 16:32:44 MET 1997 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
779
25f64a11 780 Updated version number
7a6a85bf 781
25f64a11 782 Declare VERSION as being used
7a6a85bf 783
25f64a11
AMS
784 Fixed a typo in the PerlIO_putc remapping.
785 PerlIO_read and perlIO_write inverted size/nb_items.
786 (only relevant for pre-perl5.004 versions)
7a6a85bf
RG
787
788Thu Feb 27 15:58:31 MET 1997 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
789
25f64a11 790 Updated version number
7a6a85bf 791
25f64a11 792 Added VERSION identification
7a6a85bf 793
25f64a11 794 Allow build with perl5.003, which is ante perlIO time
7a6a85bf
RG
795
796Mon Jan 13 17:53:18 MET 1997 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
797
25f64a11 798 Random code fixes.
7a6a85bf
RG
799
800Wed Jan 22 15:19:56 MET 1997 Raphael Manfredi <Raphael_Manfredi@grenoble.hp.com>
801
25f64a11 802 Updated version number in Makefile.PL.
7a6a85bf 803
25f64a11 804 Added "thanks to" section to README.
7a6a85bf 805
25f64a11 806 Documented new forgive_me variable.
7a6a85bf 807
25f64a11 808 Made 64-bit clean.
7a6a85bf 809
25f64a11
AMS
810 Added forgive_me support to allow store() of data structures
811 containing non-storable items like CODE refs.