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