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