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