Debian Codegraph @

CHANGES

raw
1 NAME
2 Class::MakeMethods::Docs::Changes - History of Class::MakeMethods
3
4 SYNOPSIS
5 Revision history for Class::MakeMethods.
6
7 CHANGES
8 Version 1.010
9
10 2004/09/01
11 Moved Template::TextBuilder and Template::DiskCache into Utility::
12 namespace.
13
14 Added support for defaults with -- and -param to Standard
15 get_declarations().
16
17 2004/08/12
18 Began integrating tied-value patches from Dominique Dumont.
19
20 2004/04/27
21 Added method types to Evaled::Hash.
22
23 2004/04/23
24 Added skeleton of a new Evaled::Hash class.
25
26 Version 1.009
27
28 2003/09/25
29 Added Emulator::mcoder and compatibility tests.
30
31 Released to CPAN as Class-MakeMethods-1.009.tar.gz.
32
33 2003/09/22
34 Added support for lvalue methods to Template and Template::Generic.
35 Added a few tests to demonstrate they're working. Added an example
36 to Docs::Examples.
37
38 Added Emulator::accessors and compatibility tests.
39
40 Minor documentation improvements.
41
42 Version 1.008
43
44 2003/09/05
45 Adjusted layout of test directories in another attempt to solve a
46 MakeMaker/shell-glob issue on Windows that was preventing make test
47 from running correctly.
48
49 Removed Template::PseudoHash, since this package never really
50 worked, as pointed out by a question from Mike Castle. Management of
51 array-based objects can be handled by any of the existing ::Array
52 subclasses, and support for pseudo-hashes would not provide any
53 useful new capabilities.
54
55 Added support for "Template::Universal:forward_methods -delegate"
56 and "Template::Generic:object --soft_delegate" based on a suggestion
57 from Peter Chen. Extended behavior of Template -subs handling to
58 make it easy to add such functionality in the future.
59
60 Released to CPAN as Class-MakeMethods-1.008.tar.gz.
61
62 2003/09/02
63 Adjusted DESTROY behavior of Template::InsideOut and cleaned up
64 documentation.
65
66 Version 1.007
67
68 2003/09/01
69 Made Template definitions automatically import their class's generic
70 definitions, if present. This eliminates the need for Generic
71 subclasses to explicitly redeclare every method it inherits, and
72 should obviate the "missing declaration" problems referenced below.
73
74 Updated the names of several Template subclasses, with stubs at the
75 old names for backwards compatibility: Flyweight becomes InsideOut,
76 Static becomes Global, and Struct becomes Array.
77
78 Added Template::Inheritable and basic tests for it.
79
80 Eliminated use of legacy Test.pm from remaining tests, except for
81 MethodMaker emulation.
82
83 Rearranged test directories in an effort to avoid a reported bug
84 with the test path of t/*/*.t under Windows.
85
86 Released to CPAN as Class-MakeMethods-1.007.tar.gz.
87
88 2003/08/27
89 Added section to Class::MakeMethods/EXTENDING documentation based on
90 question from Terrence Brannon.
91
92 2003/02/07
93 Fixed missing declaration of Template::Hash:instance, reported via
94 RT.
95
96 Version 1.006
97
98 2003/01/26
99 Additional documentation touch-ups. Moved miscellaneous POD files
100 into the Docs directory.
101
102 Added new test scripts from Class-MethodMaker-1.08, although we
103 don't yet pass them. In particular, I need to add support for the
104 new method types added in 1.04: tie_scalar, tie_list,
105 object_tie_list, object_tie_hash
106
107 Also need to compare against the changes included in
108 Class-MethodMaker-1.09 and 1.10, which don't seem to include any new
109 test code, but do include functionality changes.
110
111 2002/12/12
112 Re-integrated Template and Emulator packages; the separate
113 distribution turned out to be a hastle rather than a convenience.
114 However, in order to keep test scripts for each subsystem separate,
115 I'm now using a Makefile.PL attribute to specify a two-level deep
116 directory tree of test scripts; I hope this doesn't break on
117 Windows...
118
119 Fixed possible "use of undefined as a reference" problem in
120 Standard::*::array method generators, reported by Jared Rhine.
121
122 Tried to improve documentation, based on feedback from Jared Rhine.
123 Expunged ReadMe.pod. Extracted method catalogs into Catalog.pod.
124 Moved examples to new Example.pod, although that underlines how few
125 examples there are.
126
127 Version 1.005
128
129 2002/06/06
130 Added Autoload interface.
131
132 Modifed Attribute interface to add "inheritable" default logic for
133 Maker class parameter. (Suggested by Malcolm Cook.)
134
135 Fixed typo in documentation for Standard::Universal. (Spotted by
136 Malcolm Cook.)
137
138 Version 1.004
139
140 2002/03/23
141 Released to CPAN as Class-MakeMethods-1.004.tar.gz.
142
143 2002/03/16
144 Allow double-colons between package name and method generator name.
145
146 2002/02/19
147 Fixed related use of undef in Standard::*:hash methods.
148
149 2002/02/14
150 Adjusted Standard::*:hash methods to avoid assuming that the hashref
151 already exists.
152
153 2002/02/07
154 Added missing *_reset => clear to Template number --counter
155 interface.
156
157 2002/02/02
158 Adjusted error message in Utility::ArraySplicer
159
160 2002/01/26
161 Applied small documentation corrections suggested by Adam Spiers.
162
163 Added Standard::Universal:alias.
164
165 Version 1.003
166
167 2002/01/24
168 Folded "Getting Started Guide" POD into main module documentation.
169
170 Renamed Utility::TakeName to Emulator.
171
172 Split Template and Emulator packages into their own distributions.
173
174 Please Note: This means that to fully upgrade you must retrieve all
175 three of these files:
176
177 Class-MakeMethods-1.003.tar.gz
178 Class-MakeMethods-Template-1.003.tar.gz
179 Class-MakeMethods-Emulator-1.003.tar.gz
180
181 Of course, if you're not using the Template or Emulator classes,
182 there's no need to download them...
183
184 2002/01/21
185 Started bumping sub-version numbers and not using sub-sub-versions,
186 to shorten distribution names and more closely match standard
187 practice.
188
189 Added Composite::Inheritable:hook and matching test. Added
190 Composite->CurrentResults method to easily access, update composite
191 method results.
192
193 Version 1.000.*
194
195 v1.000.16 - 2002/01/21
196 Released to CPAN as v1.000.016.
197
198 v1.000.16 - 2002/01/20
199 Adjusted the hash and array methods in the Standard::* and
200 Composite::* packages to properly accept a set-contents call with a
201 single reference argument, and to return contents rather than ref in
202 list context.
203
204 v1.000.16 - 2002/01/14
205 Fixed a subtle bug in a test script inherited from
206 Class::MethodMaker: 4_Template_hash_hash_array.t and
207 7_MethodMaker_hash_of_lists.t both relied on "keys %hash" returning
208 the keys in a particular order, which *almost* always worked, but
209 caused failures on one or more Perl version/platform combinations.
210
211 v1.000.15 - 2002/01/14
212 Released to CPAN as v1.000.015.
213
214 v1.000.15 - 2002/01/12
215 Renamed Basic::Static to Basic::Global for consistency with Standard
216 and Composite. Hopefully, there aren't many users of this module
217 yet; please accept my apologies if this breaks your code.
218
219 Eliminated "local @_ = ...", which appears to cause a scoping
220 problem on Perl 5.6. Thanks to Adam Spiers for a thorough bug
221 report. (See http://www.perlmonks.org/index.pl?node_id=138370 for
222 details.)
223
224 Extended Template::Generic to support "array --get_set_ref" method
225 style requested by Adam Spiers.
226
227 Various documentation tweaks, including feedback from Adam Spiers:
228 Adjusted documentation to downplay Basic::* modules as a starting
229 point, in favor of Standard::* ones. Trimmed out some duplicated
230 documentation in favor of more "See L<...>" links. Adjusted
231 documentation of *::Inheritable packages in an attempt to clarify
232 the way in which the inheritance tree is searched for a value.
233
234 Factored out common code from Standard::Inheritable and
235 Composite::Inheritable to new module, Utility::Inheritable. Factored
236 out common code from Standard::Hash and Standard::Array to new
237 module, Utility::ArraySplicer. Factored out common code from
238 Template::Universal to new module, Utility::Ref. Renamed
239 Emulator::TakeName to Utility::TakeName (this is internal use only,
240 so there should be no public impact).
241
242 v1.000.15 - 2001/12/01
243 Adjusted Template::Universal's code for _CALL_METHODS_FROM_HASH_, to
244 ensure that method/arg pairs are called in order they were passed
245 in.
246
247 v1.000.15 - 2001/07/04, 2001/07/19
248 Minor additions to documentation of various method types.
249
250 v1.000.14 - 2001/07/01
251 Released as v1.000.014.
252
253 v1.000.14 - 2001/06/25, 2001/06/29, 2001/07/01
254 Removed Makefile rule from Makefile.PL to avoid warnings when used
255 with recent versions of ExtUtils::MakeMaker, which also define a
256 similar rule. (Based on bug report from Ron Savage.)
257
258 Fixed test failure for machines with P5.6 but no
259 Attribute::Handlers. (Reported by Ron Savage, Jay Lawrence.)
260
261 Added Template::Flyweight:string_index. (But still needs test
262 script.)
263
264 Added Standard::Universal. (But still needs test scripts.)
265
266 Minor touch-ups to ReadMe and Guide documentation.
267
268 v1.000.13 - 2001/05/16, 2001/05/18, 2001/05/20, 2001/06/02, 2001/06/22,
269 2001/06/24
270 To date, this module has been circulated under several provisional
271 names: it was originally floated as a possible version-2 rewrite of
272 Class::MethodMaker, then renamed to Class::Methods when it forked
273 from that project, and then briefly to Class::MethodGenerator. (Note
274 that it can be surprisingly difficult to comply with both of these
275 the perlmodlib manpage guidelines: "To be portable each component of
276 a module name should be limited to 11 characters. [...] Always try
277 to use two or more whole words.") In the end, I selected
278 Class::MakeMethods, as it is two whole words, and is reminiscent of
279 Class::MethodMaker without being confusing (I hope!), and I believe
280 this issue is now settled.
281
282 Standardized syntax for global options; renamed -implementation to
283 -MakerClass and -target_class to -TargetClass. Moved $TargetClass
284 and other context information into %CONTEXT with _context accessor.
285 Added ForceInstall.
286
287 Completed re-simplification of build directories; we're back to a
288 single Makefile, which avoids a warning in P5.6.0.
289
290 Added Attribute interface for use with P5.6 and later, based on
291 Attribute::Handlers.
292
293 Renamed "Simple" subclasses to "Basic". Added documentation and
294 initial tests.
295
296 Added Standard subclasses with parameter parsing and more powerful
297 accessors.
298
299 Modified Emulator::Struct to use Standard::* methods. Found struct
300 test from P5.7, and added auto_init functionality to match.
301
302 Added Composite::* subclasses.
303
304 Added Emulator::AccessorFast.
305
306 Added Class::MakeMethods::Guide with introduction and examples.
307
308 Continued clean-up effort on Template documentation. Renamed
309 Template "attributes" to "method parameters" to avoid confusion with
310 Perl attributes. Retitled Template naming rules from "templates" to
311 "interfaces".
312
313 Changed initialization code expressions of Template::Class in hopes
314 of P5.6.1 compatibility. (Problem reported by M Schwern.)
315
316 Added 'Template::Generic:new --and_then_init' based on feedback from
317 Jay Lawrence.
318
319 Early 1.000 versions
320
321 v1.000.12 - 2001/05/14
322 Renamed module to Class::MethodGenerator, although naming questions
323 remain.
324
325 Moved Template subclasses into Template::* namespace. Simplified
326 build directory and makefile structure.
327
328 Changed initialization code expressions of Template::PackageVar,
329 ClassVar for P5.6.0 compatibility. (Reported by M Schwern.)
330
331 v1.000.11 - 2001/05/07, 2001/05/12
332 Eliminated Bundle file. Moved general documentation to cm_base.
333
334 Renamed Class::Methods::Base to Class::Methods::Generator.
335
336 Extracted code for Template declarations to new
337 Class::Methods::Template module. Extracted disk-caching to new
338 Template::DiskCache module. Moved TextBuilder into the Template::
339 tree.
340
341 Moved _namespace_capture code to new package
342 Class::Methods::Emulator::TakeName.
343
344 Added Simple::Hash subclass.
345
346 v1.000.10 - 2001/04/26, 2001/05/02, 2001/05/04
347 Moved _namespace_capture and _namespace_release to
348 Class::Methods::Base.
349
350 Additional doc tweakage. Moved ReadMe documentation to
351 Bundle::ClassMethods. Merged Extending documentation into Base.
352
353 Removed spurious uses of -default => 'default' in templates.
354
355 Added new ClassInherit subclass and Emulator::Inheritable.
356
357 Expunged Index subclass in favor of boolean_index and string_index
358 types on Generic.
359
360 Moved Struct:builtin_isa type to new package, StructBuiltin.
361
362 Refactored code templating function as
363 Class::Methods::Base::TextBuilder.
364
365 v1.000.9 - 2001/03/24
366 Reversed sense of - and --, as it was in 1.000.1.
367
368 Separated source files into separate directories with distinct
369 Makefiles and test hierarchies. This should clarify the boundaries
370 between the core method-generation code, the common
371 constructor/accessor methods, and the various emulator and
372 experimental packages.
373
374 v1.000.8 - 2001/01/19
375 Following receipt of a suggestion to fork from the maintainer of
376 Class::MethodMaker, renamed packge from Class::MethodMaker v2.0 to
377 Class::Methods v1.000.
378
379 Adjusted documentation to reflect fork, although additional cleanup
380 is still needed.
381
382 Moved backward compatibility to Emulator::MethodMaker subclass.
383
384 Added Generic -compatibility array index_* and hash_of_arrays *_last
385 and *_set methods to match changes in Class::MethodMaker v1.02.
386 Added Emulator::MethodMaker support for the '-static' flag. The
387 emulator now completely satisfies the enclosed test suites, from
388 Class::MethodMaker v0.92 and v1.02.
389
390 v1.000.7 - 2001/01/05, 2001/01/06, 2001/01/07
391 Moved core code and internal code to Internals.pm. MethodMaker.pm
392 now contains only some require statements and the general user guide
393 documentation.
394
395 Moved ReadMe.pod, Changes.pod, and ToDo.pod into MethodMaker
396 directory. Separated Catalog.pod, Extending.pod, RelatedModules.pod.
397
398 Included version 1 docs as Class::Methods::OriginalDocs; minor
399 revisions for clarity.
400
401 Renamed Package subclass to PackageVar, Class to ClassVar.
402
403 Added Emulation::Struct subclass.
404
405 Added support for shifting targets with make( -target_class =>
406 Package, ... ).
407
408 Extended ClassName subclass to handle requiring, rather than
409 creating subclases.
410
411 v1.000.6 - 2000/12/29, 2001/01/02, 2001/01/04
412 Restored -sugar import option for compatibility with earlier
413 versions.
414
415 Added plural names to "Generic:hash -compatibility" to support v0.92
416 usage.
417
418 Replaced use of substr(..., 0, 1) with ... =~ s/^-// for P5.004
419 compatibility; problem found by Scott Godin.
420
421 Copy @_ before splicing and pushing on to it for P5.004
422 compatibility.
423
424 Expunged duplicate lines from Generic.pm's array_of_objects; found
425 by Ron Savage.
426
427 Renamed Hash.pm's delete and exists behaviors to avoid possible
428 run-time import conflict with Generic.pm's behaviors; failure
429 reported by Ron Savage.
430
431 Added _STATIC_ATTR_{return_value_undefined} attributes to Generic
432 string and number to allow overrides of this functionality.
433
434 Minor doc touchups and expanded examples section.
435
436 v1.000.5 - 2000/11/28, 2000/12/16, 2000/12/28
437 Added Universal -warn_calls modifier.
438
439 Folded various pod files together into main module's inline
440 documentation. Updated catalog of existing implementations in
441 documentation. Added pointers to some tutorials and books which
442 discuss Class::Methods.
443
444 Standardized naming of test scripts.
445
446 Can now specify default template name, via -default=>"foo".
447
448 v1.000.4 - 2000/11/22
449 Separated string, number, and boolean from the Generic scalar
450 methods.
451
452 Provide _disk_cache to shortcut the lengthy _interpret_text_builder
453 process.
454
455 Fixes to ClassName implementation.
456
457 Change to forward methods to provide better error messages when
458 object is empty.
459
460 v1.000.3 - 2000/11/03
461 Rearranged documentation into separate files in the pod/ directory.
462
463 Collapsed find_target_class and make functionality into import;
464 moved support for the old functions to the Compatibility module.
465
466 Adjusted tests to generally use standard syntax, and not
467 Compatibility hooks.
468
469 v1.000.2.1 - 2000/10/23
470 Moved commonly-accessible information to Universal.
471
472 Added block{...} replacement for enhanced behavior templating.
473
474 Added modifier mechanism to support -private and -protected.
475
476 May need to be able to specify import ordering so that modifiers are
477 applied in the right order. This hasn't bit me yet, but it's there.
478 Darn.
479
480 v1.000.2 - 2000/10/22
481 Completed generalization of Generic methods from Static and Hash.
482 Rewrote ClassVar and PackageVar to use Generic framework.
483
484 Attribute expansion can now substitute values besides name, using
485 *{attr}.
486
487 Added _diagnostics function and documentation of all failure
488 messages.
489
490 Added SEE ALSO section to documentation, brief review of Class::* on
491 CPAN. Stumbled across Damian Conway's very nice Class::Contract
492 module.
493
494 Added Scalar and Flyweight implementations.
495
496 v1.000.1.1 - 2000/10/21
497 Rolled back change from yesterday; can still pick templates like
498 '-java'. Allow attributes to be specified as '--foo'=>'bar' or
499 '--'=>{foo=>'bar'}
500
501 Automated caching for meta-method definition hashes.
502
503 Generalized several Static and Hash interfaces into Generic
504 templates. Added Static:array and Static:code support.
505
506 Allow global -import to set default sources for templates, exprs,
507 behaviors.
508
509 v1.000.1 - 2000/10/19
510 Support inheritance of templates between meta-methods with -import.
511
512 Made "template" an attribute, rather than a special state variable.
513
514 Allow any attribute to be specified as -foo=>'bar'. Changed
515 selection of standard templates from '-java' to '--java'.
516
517 Initial support for string-eval behaviors and code_exprs, and
518 Generic.pm
519
520 v1.000.0 - 2000/10/14, 2000/10/15
521 Completed initial pass of full rewrite.
522
523 Assorted cleanup of syntax and documentation.
524
525 Moved Hash, Static, and Index implementations into separate
526 packages.
527
528 v0.9.3 - 2000/09/30
529 Refactored subclass_name and class_registry.
530
531 Folded in some misc improvements from Class::MethodMaker 1.0.
532
533 v0.97x - 2000/08/04 to 2000/08/13
534 Forked from Class::MethodMaker 0.96. Substantial rewrite started
535
536 Created build_meta_method and refactored many methods to use it.
537
538 Added new_hash, hash_init, new_from_prototype.
539
540 Extended arg format. Added -template=>behavior_name. Added support
541 for array-of-names arguments.
542
543 Performance tuning. Additional refactoring to support AutoSplit
544 functionality.
545
546 Also folded in some older changes and additions from Evolution's
547 internal collection of MethodMaker subclasses:
548
549 Class::MethodMaker::Extensions
550
551 Change notes from unreleased collection of extensions to
552 Class::MethodMaker that were later folded into Class::MakeMethods:
553
554 2000/01/12 Added set_foo, clear_foo to class_var hashes.
555 1999/07/27 Added subclass_name.
556 1999/04/15 Changed class_var to use symbol table lookups, not eval "".
557 1999/04/05 Changed determine_once to check again if undefined.
558 1999/03/25 Added singleton method.
559 1998/09/18 Finished integration of class_registry handlers.
560 1998/07/31 Added class_var and classnames handlers.
561 1998/06/12 Added lookup handlers.
562 1998/05/09 Created no_op and determine_once method groups.
563