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