This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
cf741b025dfa58b6b8bd2d75419c78b265008c50
[perl5.git] / dist / Data-Dumper / Changes
1 =head1 NAME
2
3 HISTORY - public release history for Data::Dumper
4
5 =head1 DESCRIPTION
6
7 =over 8
8
9 =item 2.135_07 (Aug 06 2012)
10
11 Use the new utf8 to code point functions - fixing a potential
12 reading buffer overrun.
13
14 Data::Dumper: Sparseseen option to avoid building much of the seen
15 hash: This has been measured to, in some cases, provide a 50% speed-up
16
17 Dumper.xs: Avoid scan_vstring on 5.17.3 and up
18
19 Avoid a warning from clang when compiling Data::Dumper
20
21 Fix DD's dumping of qr|\/|
22
23 Data::Dumper's Perl implementation was not working with overloaded
24 blessed globs, which it thought were strings.
25
26 Allow Data::Dumper to load on miniperl
27
28 =item 2.135_02 (Dec 29 2011)
29
30 Makes DD dump *{''} properly.
31
32 [perl #101162] DD support for vstrings:
33 Support for vstrings to Data::Dumper, in both Perl and XS
34 implementations.
35
36 =item 2.135_01 (Dec 19 2011)
37
38 Make Data::Dumper UTF8- and null-clean with GVs.
39
40 In Dumper.xs, use sv_newmortal() instead of sv_mortalcopy(&PL_sv_undef)
41 for efficiency.
42
43 Suppress compiler warning
44
45 Keep verbatim pod in Data::Dumper within 80 cols
46
47 =item 2.131 (May 27 2011)
48
49 Essentially the same as version 2.130_02, but a production release.
50
51 =item 2.130_03 (May 20 2011)
52
53 Essentially the same as version 2.130_02, but a CPAN release
54 for the eventual 2.131.
55
56 =item 2.130_02
57
58 This was only shipped with the perl core, never released to CPAN.
59
60 Convert overload.t to Test::More
61
62 Fix some spelling errors
63
64 Fix some compiler warnings
65
66 Fix an out of bounds write in Data-Dumper with malformed utf8 input
67
68 =item 2.130 (Nov 20 2010)
69
70 C<Dumpxs> can now handle malformed UTF-8.
71
72 =item 2.129 (Oct 20 2010)
73
74 C<Dumpxs> no longer crashes with globs returned by C<*$io_ref>
75 [perl #72332].
76
77 =item 2.128 (Sep 10 2010)
78
79 Promote previous release to stable version with the correct version.
80
81 =item 2.127 (Sep 10 2010)
82
83 Promote previous release to stable version.
84
85 =item 2.126_01 (Sep  6 2010)
86
87 Port core perl changes e3ec2293dc, fe642606b19.
88 Fixes core perl RT #74170 (handle the stack changing in the
89 custom sort functions) and adds a test.
90
91 =item 2.126 (Apr 15 2010)
92
93 Fix Data::Dumper's Fix Terse(1) + Indent(2):
94 perl-RT #73604: When $Data::Dumper::Terse is true, the indentation is thrown
95 off. It appears to be acting as if the $VAR1 = is still there.
96
97 =item 2.125 (Aug  8 2009)
98
99 CPAN distribution fixes (meta information for META.yml).
100
101 =item 2.124 (Jun 13 2009)
102
103 Add three missing test files.
104
105 =item 2.123 (Jun 11 2009)
106
107 Re-add the INSTALLDIRS => 'perl' directive to Makefile.PL
108 of the CPAN release.
109
110 =item 2.122 (Jun  9 2009)
111
112 Promote previous developer release to stable release.
113
114 =item 2.121_20 (Jun  6 2009)
115
116 A host of bug fixes and improvements that have
117 accumulated in the perl core
118
119 Updated backport to 5.6.1 by Steffen Mueller <smueller@cpan.org>.
120
121 =item 2.121 (Aug 24 2003)
122
123 Backport to 5.6.1 by Ilya Martynov <ilya@martynov.org>.
124
125 =item 2.11  (unreleased)
126
127 C<0> is now dumped as such, not as C<'0'>.
128
129 qr// objects are now dumped correctly (provided a post-5.005_58)
130 overload.pm exists).
131
132 Implemented $Data::Dumper::Maxdepth, which was on the Todo list.
133 Thanks to John Nolan <jpnolan@Op.Net>.
134
135 =item 2.101 (30 Apr 1999)
136
137 Minor release to sync with version in 5.005_03.  Fixes dump of
138 dummy coderefs.
139
140 =item 2.10  (31 Oct 1998)
141
142 Bugfixes for dumping related undef values, globs, and better double
143 quoting: three patches suggested by Gisle Aas <gisle@aas.no>.
144
145 Escaping of single quotes in the XS version could get tripped up
146 by the presence of nulls in the string.  Fix suggested by
147 Slaven Rezic <eserte@cs.tu-berlin.de>.
148
149 Rather large scale reworking of the logic in how seen values
150 are stashed. Anonymous scalars that may be encountered while
151 traversing the structure are properly tracked, in case they become
152 used in data dumped in a later pass.  There used to be a problem
153 with the previous logic that prevented such structures from being
154 dumped correctly.
155
156 Various additions to the testsuite.
157
158 =item 2.09  (9 July 1998)
159
160 Implement $Data::Dumper::Bless, suggested by Mark Daku <daku@nortel.ca>.
161
162 =item 2.081  (15 January 1998)
163
164 Minor release to fix Makefile.PL not accepting MakeMaker args.
165
166 =item 2.08  (7 December 1997)
167
168 Glob dumps don't output superflous 'undef' anymore.
169
170 Fixes from Gisle Aas <gisle@aas.no> to make Dumper() work with
171 overloaded strings in recent perls, and his new testsuite.
172
173 require 5.004.
174
175 A separate flag to always quote hash keys (on by default).
176
177 Recreating known CODE refs is now better supported.
178
179 Changed flawed constant SCALAR bless workaround.
180
181 =item 2.07  (7 December 1996)
182
183 Dumpxs output is now exactly the same as Dump.  It still doesn't
184 honor C<Useqq> though.
185
186 Regression tests test for identical output and C<eval>-ability.
187
188 Bug in *GLOB{THING} output fixed.
189
190 Other small enhancements.
191
192 =item 2.06  (2 December 1996)
193
194 Bugfix that was serious enough for new release--the bug cripples
195 MLDBM.  Problem was "Attempt to modify readonly value..." failures
196 that stemmed for a misguided SvPV_force() instead of a SvPV().)
197
198 =item 2.05  (2 December 1996)
199
200 Fixed the type mismatch that was causing Dumpxs test to fail
201 on 64-bit platforms.
202
203 GLOB elements are dumped now when C<Purity> is set (using the
204 *GLOB{THING} syntax).
205
206 The C<Freezer> option can be set to a method name to call
207 before probing objects for dumping.  Some applications: objects with
208 external data, can re-bless themselves into a transitional package;
209 Objects the maintain ephemeral state (like open files) can put
210 additional information in the object to facilitate persistence.
211
212 The corresponding C<Toaster> option, if set, specifies
213 the method call that will revive the frozen object.
214
215 The C<Deepcopy> flag has been added to do just that.
216
217 Dumper does more aggressive cataloging of SCALARs encountered
218 within ARRAY/HASH structures. Thanks to Norman Gaywood 
219 <norm@godel.une.edu.au> for reporting the problem.
220
221 Objects that C<overload> the '""' operator are now handled
222 properly by the C<Dump> method.
223
224 Significant additions to the testsuite.
225
226 More documentation.
227
228 =item 2.04beta  (28 August 1996)
229
230 Made dump of glob names respect C<Useqq> setting.
231
232 [@$%] are now escaped now when in double quotes.
233
234 =item 2.03beta  (26 August 1996)
235
236 Fixed Dumpxs.  It was appending trailing nulls to globnames.
237 (reported by Randal Schwartz <merlyn@teleport.com>).
238
239 Calling the C<Indent()> method on a dumper object now correctly
240 resets the internal separator (reported by Curt Tilmes
241 <curt@ltpmail.gsfc.nasa.gov>).
242
243 New C<Terse> option to suppress the 'C<VARI<n> = >' prefix 
244 introduced.  If the option is set, they are output only when
245 absolutely essential.
246
247 The C<Useqq> flag is supported (but not by the XSUB version
248 yet).
249
250 Embedded nulls in keys are now handled properly by Dumpxs.
251
252 Dumper.xs now use various integer types in perl.h (should
253 make it compile without noises on 64 bit platforms, although
254 I haven't been able to test this).
255
256 All the dump methods now return a list of strings in a list
257 context.
258
259
260 =item 2.02beta  (13 April 1996)
261
262 Non portable sprintf usage in XS code fixed (thanks to 
263 Ulrich Pfeifer <pfeifer@charly.informatik.uni-dortmund.de>).
264
265
266 =item 2.01beta  (10 April 1996)
267
268 Minor bugfix (single digit numbers were always getting quoted).
269
270
271 =item 2.00beta  (9 April 1996)
272
273 C<Dumpxs> is now the exact XSUB equivalent of C<Dump>.  The XS version
274 is 4-5 times faster.
275
276 C<require 5.002>.
277
278 MLDBM example removed (as its own module, it has a separate CPAN 
279 reality now).
280
281 Fixed bugs in handling keys with wierd characters.  Perl can be
282 tripped up in its implicit quoting of the word before '=>'.  The
283 fix: C<Data::Dumper::Purity>, when set, always triggers quotes
284 around hash keys.
285
286 Andreas Koenig <k@anna.in-berlin.de> pointed out that handling octals
287 is busted.  His patch added.
288
289 Dead code removed, other minor documentation fixes.
290
291
292 =item 1.23      (3 Dec 1995)
293
294 MLDBM example added.
295
296 Several folks pointed out that quoting of ticks and backslashes 
297 in strings is missing. Added.
298
299 Ian Phillipps <ian@pipex.net> pointed out that numerics may lose 
300 precision without quotes.  Fixed.
301
302
303 =item 1.21     (20 Nov 1995)
304
305 Last stable version I can remember.
306
307 =back
308
309 =cut