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