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