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