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