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