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