<?xml version="1.0" encoding="windows-1252"?>
<node id="1180" title="perlman:Dumper::Changes" created="1999-12-22 19:51:35" updated="2005-08-10 15:41:17">
<type id="119">
perlfunc</type>
<author id="113">
root</author>
<data>
<field name="doctext">
</field>
<field name="name">

&lt;P&gt;

&lt;FONT SIZE=-1&gt;HISTORY&lt;/FONT&gt; - public release history for Data::Dumper

&lt;P&gt;
&lt;HR&gt;
</field>
<field name="synopsis">
</field>
<field name="description">

&lt;OL&gt;
&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_09_9_July_1998_"&gt;09  (9 July 1998)&lt;/A&gt;&lt;/STRONG&gt;
&lt;P&gt;
Implement $Data::Dumper::Bless, suggested by Mark Daku &amp;lt;&lt;A
HREF="mailto:daku@nortel.ca"&gt;daku@nortel.ca&lt;/A&gt;&amp;gt;

&lt;P&gt;&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_081_15_January_1998_"&gt;081  (15 January 1998)&lt;/A&gt;&lt;/STRONG&gt;

Minor release to fix Makefile.PL not accepting MakeMaker args.

&lt;P&gt;&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_08_7_December_1997_"&gt;08  (7 December 1997)&lt;/A&gt;&lt;/STRONG&gt;

Glob dumps don't output superflous 'undef' anymore.

&lt;P&gt;
Fixes from Gisle Aas &amp;lt;&lt;A HREF="mailto:gisle@aas.no"&gt;gisle@aas.no&lt;/A&gt;&amp;gt; to make 
&lt;CODE&gt;Dumper()&lt;/CODE&gt; work with overloaded strings in recent perls, and his new testsuite.

&lt;P&gt;
require 5.004.

&lt;P&gt;

&lt;FONT SIZE=-1&gt;A&lt;/FONT&gt; separate flag to always quote hash keys (on by
default).

&lt;P&gt;
Recreating known 
&lt;FONT SIZE=-1&gt;CODE&lt;/FONT&gt; refs is now better supported.

&lt;P&gt;
Changed flawed constant 
&lt;FONT SIZE=-1&gt;SCALAR&lt;/FONT&gt; bless workaround.

&lt;P&gt;&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_07_7_December_1996_"&gt;07  (7 December 1996)&lt;/A&gt;&lt;/STRONG&gt;

Dumpxs output is now exactly the same as Dump. It still doesn't honor &lt;CODE&gt;Useqq&lt;/CODE&gt; though.

&lt;P&gt;
Regression tests test for identical output and [perlfunc:eval|eval]-ability.

&lt;P&gt;
Bug in 
&lt;FONT SIZE=-1&gt;*GLOB{THING}&lt;/FONT&gt; output fixed.

&lt;P&gt;
Other small enhancements.

&lt;P&gt;&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_06_2_December_1996_"&gt;06  (2 December 1996)&lt;/A&gt;&lt;/STRONG&gt;

Bugfix that was serious enough for new release--the bug cripples 
&lt;FONT SIZE=-1&gt;MLDBM.&lt;/FONT&gt; Problem was ``Attempt to modify readonly value...'' failures that stemmed for a misguided 
&lt;CODE&gt;SvPV_force()&lt;/CODE&gt; instead of a 
&lt;CODE&gt;SvPV().)&lt;/CODE&gt;

&lt;P&gt;&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_05_2_December_1996_"&gt;05  (2 December 1996)&lt;/A&gt;&lt;/STRONG&gt;

Fixed the type mismatch that was causing Dumpxs test to fail on 64-bit
platforms.

&lt;P&gt;

&lt;FONT SIZE=-1&gt;GLOB&lt;/FONT&gt; elements are dumped now when &lt;CODE&gt;Purity&lt;/CODE&gt; is set (using the 
&lt;FONT SIZE=-1&gt;*GLOB{THING}&lt;/FONT&gt; syntax).

&lt;P&gt;
The &lt;CODE&gt;Freezer&lt;/CODE&gt; option can be set to a method name to call before probing objects for
dumping. Some applications: objects with external data, can re-bless
themselves into a transitional package; Objects the maintain ephemeral
state (like open files) can put additional information in the object to
facilitate persistence.

&lt;P&gt;
The corresponding &lt;CODE&gt;Toaster&lt;/CODE&gt; option, if set, specifies the method call that will revive the frozen
object.

&lt;P&gt;
The &lt;CODE&gt;Deepcopy&lt;/CODE&gt; flag has been added to do just that.

&lt;P&gt;
Dumper does more aggressive cataloging of SCALARs encountered within 
&lt;FONT SIZE=-1&gt;ARRAY/HASH&lt;/FONT&gt; structures. Thanks to Norman Gaywood &amp;lt;&lt;A
HREF="mailto:norm@godel.une.edu.au"&gt;norm@godel.une.edu.au&lt;/A&gt;&amp;gt; for
reporting the problem.

&lt;P&gt;
Objects that &lt;CODE&gt;overload&lt;/CODE&gt; the '``''' operator are now handled properly by the &lt;CODE&gt;Dump&lt;/CODE&gt; method.

&lt;P&gt;
Significant additions to the testsuite.

&lt;P&gt;
More documentation.

&lt;P&gt;&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_04beta_28_August_1996_"&gt;04beta  (28 August 1996)&lt;/A&gt;&lt;/STRONG&gt;

Made dump of glob names respect &lt;CODE&gt;Useqq&lt;/CODE&gt; setting.

&lt;P&gt;
&amp;#091;@$%&amp;#093; are now escaped now when in double quotes.

&lt;P&gt;&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_03beta_26_August_1996_"&gt;03beta  (26 August 1996)&lt;/A&gt;&lt;/STRONG&gt;

Fixed Dumpxs. It was appending trailing nulls to globnames. (reported by
Randal Schwartz &amp;lt;&lt;A
HREF="mailto:merlyn@teleport.com"&gt;merlyn@teleport.com&lt;/A&gt;&amp;gt;

&lt;P&gt;
Calling the &lt;CODE&gt;Indent()&lt;/CODE&gt; method on a dumper object now correctly resets the internal separator
(reported by Curt Tilmes &amp;lt;&lt;A
HREF="mailto:curt@ltpmail.gsfc.nasa.gov"&gt;curt@ltpmail.gsfc.nasa.gov&lt;/A&gt;&amp;gt;

&lt;P&gt;
New &lt;CODE&gt;Terse&lt;/CODE&gt; option to suppress the '&lt;CODE&gt;VAR&amp;lt;EM&amp;gt;n&amp;lt;/EM&amp;gt; = &lt;/CODE&gt;' prefix introduced. If the option is set, they are output only when
absolutely essential.

&lt;P&gt;
The &lt;CODE&gt;Useqq&lt;/CODE&gt; flag is supported (but not by the 
&lt;FONT SIZE=-1&gt;XSUB&lt;/FONT&gt; version yet).

&lt;P&gt;
Embedded nulls in keys are now handled properly by Dumpxs.

&lt;P&gt;
Dumper.xs now use various integer types in perl.h (should make it compile without noises on 64 bit platforms, although 
&lt;FONT SIZE=-1&gt;I&lt;/FONT&gt; haven't been able to test this).

&lt;P&gt;
All the dump methods now return a list of strings in a list context.

&lt;P&gt;&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_02beta_13_April_1996_"&gt;02beta  (13 April 1996)&lt;/A&gt;&lt;/STRONG&gt;

Non portable sprintf usage in 
&lt;FONT SIZE=-1&gt;XS&lt;/FONT&gt; code fixed (thanks to Ulrich Pfeifer &amp;lt;&lt;A
HREF="mailto:pfeifer@charly.informatik.uni-dortmund.de"&gt;pfeifer@charly.informatik.uni-dortmund.de&lt;/A&gt;&amp;gt;

&lt;P&gt;&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_01beta_10_April_1996_"&gt;01beta  (10 April 1996)&lt;/A&gt;&lt;/STRONG&gt;

Minor bugfix (single digit numbers were always getting quoted).

&lt;P&gt;&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_00beta_9_April_1996_"&gt;00beta  (9 April 1996)&lt;/A&gt;&lt;/STRONG&gt;

&lt;CODE&gt;Dumpxs&lt;/CODE&gt; is now the exact 
&lt;FONT SIZE=-1&gt;XSUB&lt;/FONT&gt; equivalent of &lt;CODE&gt;Dump&lt;/CODE&gt;. The 
&lt;FONT SIZE=-1&gt;XS&lt;/FONT&gt; version is 4-5 times faster.

&lt;P&gt;
&lt;CODE&gt;require 5.002&lt;/CODE&gt;.

&lt;P&gt;

&lt;FONT SIZE=-1&gt;MLDBM&lt;/FONT&gt; example removed (as its own module, it has a separate 
&lt;FONT SIZE=-1&gt;CPAN&lt;/FONT&gt; reality now).

&lt;P&gt;
Fixed bugs in handling keys with wierd characters. Perl can be tripped up
in its implicit quoting of the word before '=&amp;gt;'. The fix: &lt;CODE&gt;Data::Dumper::Purity&lt;/CODE&gt;, when set, always triggers quotes around hash keys.

&lt;P&gt;
Andreas Koenig &amp;lt;&lt;A
HREF="mailto:k@anna.in-berlin.de"&gt;k@anna.in-berlin.de&lt;/A&gt;&amp;gt; pointed out
that handling octals is busted. His patch added.

&lt;P&gt;
Dead code removed, other minor documentation fixes.

&lt;P&gt;&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_23_3_Dec_1995_"&gt;23      (3 Dec 1995)&lt;/A&gt;&lt;/STRONG&gt;


&lt;FONT SIZE=-1&gt;MLDBM&lt;/FONT&gt; example added.

&lt;P&gt;
Several folks pointed out that quoting of ticks and backslashes in strings
is missing. Added.

&lt;P&gt;
Ian Phillips &amp;lt;&lt;A HREF="mailto:ian@pipex.net"&gt;ian@pipex.net&lt;/A&gt;&amp;gt;
pointed out that numerics may lose precision without quotes. Fixed.

&lt;P&gt;&lt;LI&gt;&lt;STRONG&gt;&lt;A NAME="item_21_20_Nov_1995_"&gt;21     (20 Nov 1995)&lt;/A&gt;&lt;/STRONG&gt;

Last stable version 
&lt;FONT SIZE=-1&gt;I&lt;/FONT&gt; can remember.

&lt;/OL&gt;
&lt;HR&gt;
</field>
</data>
</node>
