bump version to 0.71_02 and update Changes
[gitmo/Class-MOP.git] / Changes
CommitLineData
7c90a1a8 1Revision history for Perl extension Class-MOP.
b817e248 2
6b5ac420 30.71_02 Fri, December 5, 2008
62a0a0f3 4 * Class::MOP::Immutable
5 - Added a new attribute, inlined_constructor, which is true if
6 the constructor was inlined.
fdc6771b 7 * Class::MOP::Package
8 - Make get_all_package_symbols return a hash ref in scalar
9 context and deprecate calling it in list context with a
10 warning. (Florian Ragwitz)
11 * MOP.xs
12 - Various improvements and refactoring, making things more robust and
13 easier to maintain. (Florian Ragwitz)
62a0a0f3 14
34147f49 150.71_01 Wed, December 3, 2008
25a5f083 16 * Class::MOP::Method
17 - Add an "execute" method to invoke the body so
18 we can avoid using the coderef overload (Sartak)
41885bab 19 * Class::MOP::Immutable
9ec62360 20 - When we memoize methods, get their results lazily
21 to remove some compile-time cost (Sartak)
41885bab 22 - Small speedup from eliminating several method
23 calls (Sartak)
05e183d1 24 * Class::MOP::Class
25 - Some small internal tweaks to try to reduce the number of
26 times we call get_method_map when bootstrapping the MOP. This
27 might make loading Class::MOP (and Moose) a little
28 faster. (Dave Rolsky)
52e5f955 29 - Implemented an optional XS version of get_method_map. Mostly
30 taken from a patch by Goro Fuji (rt.cpan.org #41080), with
31 help form Florian Ragwitz. (Dave Rolsky)
7ef2f4b7 32 - Make the behaviour of of get_all_package_symbols (and
33 therefore get_method_map) consistent for stub methods. Report
34 and test by Goro Fuji (rt.cpan.org #41255). (Florian Ragwitz)
25a5f083 35
96185d43 360.71 Wed November 26, 2008
d652fbd5 37 * Class::MOP::Class
38 * Class::MOP::Module
39 - Actual package creation has moved upward from
40 Class to Module so that Moose roles can share
41 the code (Sartak)
42
88b8ac17 430.70_01 Mon, November 19, 2008
44 * Class::MOP
45 - Fixes for failures with blead (Florian Ragwitz)
46 - Silenced compiler warnings (Florian Ragwitz)
47
480.70 Fri, November 14, 2008
7329b9e2 49 * Class::MOP
50 - Fixed an odd corner case where the XS version of
9b1760fc 51 get_all_package_symbols could cause a segfault. This only
7329b9e2 52 happened with inlined constants in Perl 5.10.0 (Florian
53 Ragwitz)
7329b9e2 54
52c685d3 550.69 Fri, November 7, 2008
b88aa2e8 56 * Class::MOP::Method::Wrapped
57 - Added introspection methods for method modifiers (Dave Rolsky)
58
59
4a9e02e8 600.68 Fri October 24, 2008
dfbc4d4c 61 * Class::MOP
62 - Make load_class require by file name instead of module name.
63 This stops confusing error messages when loading '__PACKAGE__'.
64 (Florian Ragwitz)
5a24cf8a 65 - Add load_one_class_of function to enable you to load one of a
66 list of classes, rather than having to call load_class multiple
67 times in an eval. (t0m)
dfbc4d4c 68
5f5ee28a 690.67 Tue October 14, 2008
2e7eb96b 70 * Class::MOP::Class
71 - Call a method on the class after setting the superclass list
72 so that we can get Perl to detect cycles before MRO::Compat
73 spirals into an infinite loop (sartak)
74 - Reported by Schwern, [rt.cpan.org #39001]
34d04967 75 - In create(), pass unused options on to initialize()
76 - added test for this
2e7eb96b 77
34d04967 780.66 Sat September 20, 2008
fe05cbbe 79 !! This release has an incompatible change regarding !!
80 introspection of a class's method with Class::MOP::Class !!
81
9e9e6b8f 82 * Tests and XS
83 - We (us maintainers) now run all tests with XS and then without
84 XS, which should help us catch skew between the XS/pure Perl
e073e667 85 code. (Dave Rolsky)
9e9e6b8f 86
91b73829 87 * Class::MOP::Class
fe05cbbe 88 ! The alias_method method has been deprecated. It now simply
1190621f 89 calls add_method instead. There is no distinction between
90 aliased methods and "real" methods.
fe05cbbe 91
92 This means that methods added via alias_method now show up as
7143219b 93 part of the class's method list/map. This is a backwards
fe05cbbe 94 incompatible change, but seems unlikely to break any
95 code. Famous last words. (Dave Rolsky)
91b73829 96
155f0cba 97 * Class::MOP::Class
98 - Fixed the spelling of "compatibility", but we still have a
99 "check_metaclass_compatability" method for backwards
100 compatibility.
9e9e6b8f 101
94278c1b 1020.65 Mon September 1, 2008
103 For those not following the series of dev releases, the changes
8b9106cf 104 from 0.64 from 0.65 can mostly be summed up as a lot performance
94278c1b 105 improvements by nothingmuch, including new optional XS versions of
106 some methods. Also, Class::MOP now works _without_ any XS modules,
107 for sad systems without a compiler.
108
988fb42e 109 * Class::MOP::Method
110 - Added name and package_name XS accessors, and make sure all
111 the XS and Perl versions work the same way. (Dave Rolsky)
112
113 * MOP.xs
114 - The XS versions of various methods just returned undef when
115 called class methods, rather than dying like the pure Perl
116 versions. (Dave Rolsky)
117
13ac653a 1180.64_07 Fri August 29, 2008
400982e3 119 * Class::MOP
13ac653a 120 - Silenced warnings that managed to break Moose tests when XS
121 was loaded. (Dave Rolsky)
122 - Some XS versions of methods were ignored because of typos in
123 MOP.xs. (Dave Rolsky)
400982e3 124
13ac653a 1250.64_06 Mon August 25, 2008
9457b596 126 * Class::MOP (MOP.xs)
127 - Another MS VC++ fix, cannot declare a variable in the middle
128 of a scope (Taro Nishino).
129
1300.64_05 Sun August 24, 2008
2a755fe8 131 * Class::MOP
132 - None of the dev releases actually loaded the XS properly, but
133 we silently fell back to the pure Perl version of the
134 code. (Dave Rolsky)
135
136 * Class::MOP (MOP.xs)
137 - Replaced some code that used functions not available on Visual
138 C++ with some Perl XS API bits (Dave Rolsky).
139
f65af096 1400.64_04 Sat August 23, 2008
9ebc265d 141 * Class::MOP::Class
f65af096 142 - Workaround a bug in 5.8.1's goto sub (nothingmuch)
143
144 * pod.t and pod_coveraget.t
145 - These are no longer shipped with the tarball because of bogus
146 failures from CPAN testers. (Dave Rolsky)
9ebc265d 147
df7077cd 1480.64_03 Thu August 21, 2008
149 * Class::MOP::Package
150 - Some (legit) code was misparsed by earlier 5.8.x
151 releases. (nothingmuch)
152
153 * Class::MOP
154 - Fix a constant in void context warning (nothingmuch)
155
09ed1ec5 1560.64_02 Thu August 21, 2008
64c591d3 157 * Makefile.PL and Class::MOP
4dde2f23 158 - Explicitly require Perl 5.8.0+ (Dave Rolsky)
159
160 * Makefile.PL
161 - Add missing prereqs that got lost in the switch away from
162 Module::Install.
64c591d3 163
09ed1ec5 164 * Class::MOP::Instance
165 - New method - get_all_attributes (nothingmuch)
166
1670.64_01 Wed August 20, 2008
f125b31e 168 * Makefile.PL
169 - We now check to see if you have a compiler. If you don't, the
170 module installs without some XS bits, but will work the same
171 as with XS. This should make it easier to install on platforms
172 without a compiler (like Windows). (Dave Rolsky)
2e5c1a3f 173
40b3c18f 174 * many modules
7f799c13 175 - Perl 6 style attribute naming replaced with sane style ('methods', not
176 '%!methods'). These changes should not impact any existing API uses.
177 (nothingmuch).
178
179 * many modules
40b3c18f 180 - Quite a number of optimizations based on profiling, including
181 allowing constructors to take hash references instead of
182 hashes, duplicating some frequently used code in XS, and
183 making constructors immutable. These changes should not impact
184 any existing API uses. (nothingmuch)
185
7f799c13 186 * Many modules
187 - Constructors now respect the meta attributes of their subclasses,
188 facilitating MOP extensibility. More related changes will happen in the
189 next several releases. (nothingmuch)
190
40b3c18f 191 * Class::MOP::Class
7f799c13 192 - New method - get_all_methods, replaces the deprecated
193 compute_all_applicable_methods. get_all_attributes provided for
194 consistency (nothingmuch)
195 - New method - wrap_method was refactored out of get_method_map
196 (nothingmuch)
197 - New API for meta instance invalidation - invalidate_meta_instance,
198 invalidate_meta_instances, add_dependent_meta_instance,
199 remove_dependent_meta_instance, called automatically when attribute
200 definitions change and allows notification of dependent subclasses.
201 (nothingmuch)
40b3c18f 202
7202116b 2030.64 Sun August 3, 2008
84bc89b3 204 * Class::MOP::Immutable
7202116b 205 - fixing subtle edge case in immutable when you
84bc89b3 206 call ->meta (stevan)
7202116b 207 - clean up option processing (nothingmuch)
208
209 * Class::MOP::Instance
210 - inlined initialize slot didn't match
211 non-inlined (nothingmuch)
84bc89b3 212
f079b1eb 2130.63 Mon July 7, 2008
07940968 214 * Class::MOP
215 - load_class will initialize a metaclass even if
216 the class is already loaded (sartak)
217 - load_class now returns the metaclass instance
218 instead of just 1 (sartak)
6e1c8b63 219
f079b1eb 220 * elsewhere
221 - better error messages (sartak and Dave Rolsky)
222
ebce5539 2230.62 Wed June 18, 2008
1377b506 224 - in is_class_loaded, recognize scalar references (as opposed to globs) in
225 the symbol table as methods (these are optimized constant subs)
226
70ad0655 2270.61 Fri. June 13, 2008
228 - Okay, lets give this another try and see if PAUSE
229 recognizes it correct this time.
a023763e 230
2310.60 Thurs. Jun 12, 2008
809a26fc 232 - Fixed a version number issue by bumping all modules
233 to 0.60.
8c5cc782 234
2350.59 Thurs. Jun 12, 2008
d1dba7a1 236 !! Several fixes resulting in yet another 25-30% speedup !!
9b522fc4 237
238 * Class::MOP::Class
239 - now stores the instance of the instance
240 metaclass to avoid needless recomputation
8b49a472 241 and deletes it when the cache is blown
119f3a92 242 - introduce methods to query Class::MOP::Class for
243 the options used to make it immutable as well as
244 the proper immutable transformer. (groditi)
8b49a472 245
246 * Class::MOP::Package
247 - {add, has, get, remove}_package_symbol all
248 now accept a HASH ref argument as well as the
249 string. All internal usages now use the HASH
250 ref version.
f6dc69d2 251
252 * Class::MOP
253 - MOP.xs does sanity checks on the coderef
254 to avoid a segfault
26fcef27 255 - is_class_loaded check now uses code that
256 was improved in Moose's ClassName type
ab5e2f48 257 check (Sartak)
258 - nonsensical (undef, empty, reference) class
259 names now throw a more direct error in
260 load_class (Sartak)
3f7759c1 261 - tests for this and other aspects of
262 load_class (Sartak)
9b522fc4 263
264 * Class::MOP
265 Class::MOP::Class
266 Class::MOP::Method
267 Class::MOP::Method::Wrapped
268 Class::MOP::Attribute
269 - switched usage of reftype to ref because
270 it is much faster
271
352c364f 2720.58 Thurs. May 29, 2008
62781d9f 273 (late night release engineering)--
274
275 - fixing the version is META.yml, no functional
276 changes in this release
277
de0f9e1c 2780.57 Wed. May 28, 2008
d1dba7a1 279 !! Several speedups resulting in 20-25% speedups !!
de0f9e1c 280 || (thanks to konobi, groditi, mst & CataMoose) !!
281
ae234dc6 282 * Class::MOP::Class
283 - made get_method_map use list_all_package_symbols
284 instead of manually grabbing each symbol
de0f9e1c 285 - streamlining &initialize somewhat, since it gets
286 called so much
ae234dc6 287
288 * Class::MOP::Package
289 - made {get, has}_package_symbol not call
290 &namespace so much
de0f9e1c 291 - inlining a few calls to &name with
292 direct HASH access key access
ae234dc6 293 - added get_all_package_symbols to fetch
294 a HASH of items based on a type filter
295 similar to list_all_package_symbols
296 - added tests for this
297
32202ce2 298 * Class::MOP::Method
299 Class::MOP::Method::Constructor
300 Class::MOP::Method::Generated
301 Class::MOP::Method::Accessor
302 - added more descriptive error message to help
303 keep people from wasting time tracking an error
47e20ba2 304 that is easily fixed by upgrading.
32202ce2 305
d1dba7a1 306 * Class::MOP::Immutable
307 - Don't inline a destructor unless the user actually
308 needs one
309 - added tests for this
310
b4009dc1 3110.56 Saturday, May 24, 2008
11b56828 312 * Class::MOP
313 - we now get the &check_package_cache_flag
314 function from MRO::Compat
d7d3f3cb 315 - All XS based functionality now has a
316 Pure Perl alternative
6c34db07 317 - the CLASS_MOP_NO_XS environment variable
d7d3f3cb 318 can now be used to force non-XS versions
6c34db07 319 to always be used
11b56828 320
9e517e01 321 * Class::MOP::Attribute
322 - add has_read_method and has_write_method
d7d3f3cb 323 - get_{read,write}_method_ref now wraps the
def5c0b5 324 anon-sub ref in the method metaclass when
325 possible
326 - added tests for this
d7d3f3cb 327
5f3efd66 328 * Class::MOP::Immutable
d7d3f3cb 329 - added the ability to "wrap" methods when
5f3efd66 330 making the class immutable
d7d3f3cb 331
5f3efd66 332 * Class::MOP::Class
daf8d8bc 333 - now handling the edge case of ->meta->identifier
d7d3f3cb 334 dying by wrapping add_package_symbol to specifically
5f3efd66 335 allow for it to work.
336 - added tests for this
d7d3f3cb 337
338 * Class::MOP::Attribute
6c34db07 339 Class::MOP::Class
d7d3f3cb 340 Class::MOP::Immutable
6c34db07 341 - any time a method meta object is constructed
d7d3f3cb 342 we make sure to pass the correct package and
6c34db07 343 method name information
d7d3f3cb 344
6c34db07 345 * Class::MOP::Method
346 Class::MOP::Method::Wrapped
347 Class::MOP::Method::Generated
348 Class::MOP::Method::Accessor
d7d3f3cb 349 Class::MOP::Method::Consructor
350 - the &wrap constructor method now requires that a
351 'package_name' and 'name' attribute are passed. This
352 is to help support the no-XS version, and will
353 throw an error if these are not supplied.
6c34db07 354 - all these classes are now bootstrapped properly
355 and now store the package_name and name attributes
d7d3f3cb 356 correctly as well
357
358 ~ Build.PL has been removed since the
359 Module::Install support has been removed
9e517e01 360
8adaad20 3610.55 Mon. April 28, 2008
362 - All classes now have proper C3 MRO support
363 - added MRO::Compat as a dependency to allow
364 for the C3 MRO support to Just Work in all
365 perl versions
d7d3f3cb 366
830b326c 367 * Class::MOP::Class
d7d3f3cb 368 - rebless_instance now returns the instance
369 it has just blessed, this is mostly to
830b326c 370 facilitate chaining
d7d3f3cb 371 - set the attr correctly in rebless_instance
6e2a700f 372 when it has no init_arg
77a143ba 373 - tweaked &linear_isa and &class_precedence_list
374 to support c3 classes.
830b326c 375
e0db39d2 3760.54 Fri. March, 14, 2008
8861fab2 377 * Class::MOP
214e4bd7 378 metaclass.pm
8861fab2 379 - making sure that load_class never gets
d7d3f3cb 380 passed a value from @_ or $_ to squash
8861fab2 381 Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
382
09c6e1d2 383 * Class::MOP::Class
384 - make_{immutable,mutable} now return 1
385 (cause Sartak asked)
d7b2249e 386 - improved error handling in ->create method
d7d3f3cb 387 - rebless_instance now takes extra params which
388 will be used to populate values
214e4bd7 389 - added tests for this
d7d3f3cb 390
acce7fd6 391 * Class::MOP::Object
d7d3f3cb 392 - localizing the Data::Dumper configurations so
393 that it does not pollute others (RT #33509)
394
d7b2249e 395 * Class::MOP::Class
396 Class::MOP::Package
397 Class::MOP::Module
398 Class::MOP::Method
399 Class::MOP::Attribute
d7d3f3cb 400 - these classes no longer define their own ->meta,
401 but instead just inherit from Class::MOP::Object
402
d7b2249e 403 * Class::MOP::Instance
d7d3f3cb 404 Class::MOP::Immutable
d7b2249e 405 - these classes now inherit from Class::MOP::Object
d7d3f3cb 406
10dd437b 407 * t/
d7d3f3cb 408 - fixed the filename length on several
10dd437b 409 test files so we install on VMS better
410 (RT #32295)
d7d3f3cb 411 - fixed incorrect use of catdir when it
10dd437b 412 should be catfile (RT #32385)
413
2491730f 4140.53 Thurs. Feb. 14, 1008
7a536297 415 ~~ several doc. fixes and updates ~~
d7d3f3cb 416
0c6f4c4a 417 * Class::MOP::Class
418 Class::MOP::Method::Constructor
419 Class::MOP::Attribute
420 - making init_arg accept an undefined value
d7d3f3cb 421 to indicate that no constructor args can
0c6f4c4a 422 be passed (thanks to nothingmuch)
423 - added tests for this
339264d8 424 - added attribute initializer attribute (rjbs)
d7d3f3cb 425
0c6f4c4a 426 * Class::MOP.
427 - making this use the new init_arg => undef
d7d3f3cb 428 feature instead of the silly hack from
0c6f4c4a 429 before (thanks to nothingmuch)
ad074154 430
3e8e8f07 4310.52 Tues. Jan. 22, 2008
2a2b8458 432 * Class::MOP::Class
d7d3f3cb 433 - fixed bug in rebless_instance
2a2b8458 434 (discovered by ash)
435
436 * Class::MOP::Method::Constructor
d7d3f3cb 437 - removed assumptions about the existence of
2a2b8458 438 a &meta method
439
656ce3ba 4400.51 Mon. Jan. 14, 2008
69e3ab0a 441 ~~~ some misc. doc. fixes ~~~
442 ~~ updated copyright dates ~~
d7d3f3cb 443
c1d5345a 444 * Class::MOP
d7d3f3cb 445 - now sets the IS_RUNNING_ON_5_10
c1d5345a 446 constant so that we can take advantage
447 of some of the nice bits of 5.10
d7d3f3cb 448
c1d5345a 449 * Class::MOP::Class
d7d3f3cb 450 - uses the IS_RUNNING_ON_5_10 flag to
451 optimize the &linearized_isa method
c1d5345a 452 and avoid the hack/check for circular
d7d3f3cb 453 inheritence in &class_precedence_list
3d9e4646 454 - added rebless_instance method (Sartak)
455 - added tests for this
d7d3f3cb 456
457 * Class::MOP::Immutable
458 - the immutable class now keeps track of
c1d5345a 459 the transformer which immutablized it
69e3ab0a 460
3d9e4646 461 * Class::MOP::Instance
462 - added rebless_instance_structure method (Sartak)
463 - added tests for this
464
a780a6ff 4650.50 Fri. Dec. 21, 2007
6ff0d647 466 * Class::MOP::Class
d7d3f3cb 467 - fixed bug in immutable to make sure that
468 transformation arguments are saved
6ff0d647 469 correctly (mst)
b6bcc3a5 470 - added tests for this
d7d3f3cb 471
6ff0d647 472 * Class::MOP::Immutable
473 - fixed a bug (see above)
d7d3f3cb 474
6ff0d647 475 * Class::MOP::Attribute
476 - some doc updates
477
30b8af04 4780.49 Fri. Dec. 14, 2007
b6bcc3a5 479 !! Class::MOP now loads 2 x faster !!
30b8af04 480 !! with XS speedups (thanks konobi) !!
d7d3f3cb 481
30b8af04 482 * Class::MOP
483 - removed the dependency on B
484 - added two XS functions (thanks konobi)
485 - get_code_info($code) which replaces all
486 the B fiddling we were doing with
487 faster/leaner XS level fiddling
d7d3f3cb 488 - check_package_cache_flag($pkg_name) which
489 returns the PL_sub_generation variable to
30b8af04 490 be used to help manage method caching.
d7d3f3cb 491
492 NOTE:
493 In 5.10 or greater this will actually
494 use the mro::get_pkg_gen instead to give
495 even more accurate caching information.
30b8af04 496 blblack++ for that stuff :)
d7d3f3cb 497
6c9f390e 498 * Class::MOP::Class
499 - added the &subclasses method (thanks rlb)
d7d3f3cb 500 - added the update_package_cache_flag and
501 reset_package_cache_flag which help keep
502 track of when we need to re-fetch the
503 method map.
30b8af04 504 - Several small improvements to take advantage
505 of the new method map caching features
4c4a6c41 506
1b8b3e09 5070.48 Mon. Nov. 26, 2007
d14f6cbe 508 * Class::MOP::Attribute
d7d3f3cb 509 - fixed get_read/write_method to handle the
510 HASH ref case, which makes the
d14f6cbe 511 get_read/write_method_ref handle it too.
512 - added more tests for this
513
742fb371 5140.47 Sat. Nov. 24, 2007
515 * Class::MOP::Attribute
516 - fixed misspelling in get_write_method_ref
78d9bb38 517 - added more tests for this
742fb371 518
fe7c0b15 5190.46 Fri. Nov. 23, 2007
b7bdffc3 520 * Class::MOP::Class
d7d3f3cb 521 - added the linearized_isa method instead of constantly
522 pruning duplicate classes (this will be even more
b7bdffc3 523 useful in the 5.10-compat version coming soon)
d7d3f3cb 524
5da16d1b 525 * Class::MOP::Attribute
526 - added the get_read_method_ref and get_write_method_ref
d7d3f3cb 527 methods which allow you to retrieve a CODE ref which
5da16d1b 528 can always be used to read or write an attribute.
b7bdffc3 529
1a5cc82e 5300.45 Thurs. Nov. 13, 2007
232c4e13 531 * Class::MOP::Attribute
532 - Fix error message on confess (groditi)
533
544143b2 5340.44 Thurs. Nov. 13, 2007
535 - Apparently I didn't make dist correctly (groditi)
536
c0aeeb91 5370.43 Thurs. Nov. 13, 2007
b08fd50c 538 * Class::MOP
1d68af04 539 - Add support for the 'builder' attribute (groditi)
540
b08fd50c 541 * Class::MOP::Class
d7d3f3cb 542 - optimise metaclass-already-exists check in
b08fd50c 543 construct_class_instance (groditi)
d7d3f3cb 544 - duplicate check into initialize to save a
b08fd50c 545 call through (groditi)
546
1d68af04 547 * Class::MOP::Attribute
548 - Add support for the 'builder' attribute (groditi)
d7d3f3cb 549 - Make predicates check for the existence of a value, not whether
b08fd50c 550 it is defined (groditi)
8768ecf3 551
552 * Class::MOP::Instance
d7d3f3cb 553 - Make predicates check for the existence of a value, not whether
b08fd50c 554 it is defined (groditi)
8768ecf3 555
d7d3f3cb 556 * Class::MOP::Method::Accessor
565f0cbb 557 - made this a subclass of Class::MOP::Method::Generated
558 - removed the relevant attributes
559
560 * Class::MOP::Method::Constructor
561 - fixed the cached values we had to be more sane
562 - made this a subclass of Class::MOP::Method::Generated
d7d3f3cb 563 - fixed generated constructor so it properly handles
565f0cbb 564 subclasses now.
565 - added tests for this
d7d3f3cb 566 - added the option to allow for both inlined and
565f0cbb 567 non-inlined constructors.
b08fd50c 568 - Update inlined methods for builder and predicate changes (groditi)
565f0cbb 569
570 * Class::MOP::Method::Generated
d7d3f3cb 571 - added this class as an abstract base for the
565f0cbb 572 Class::MOP::Method::{Constructor,Accessor} classes
573 - added tests for this
574
b08fd50c 575 *t/
576 - Alter tests (005, 014 020, 021) for new builder addition (groditi)
577 - Tests for new predicate behavior (and corrections to old tests) (groditi)
578
579 *examples/
580 - Update ArrayRef based class example to work with predicate changes
581
367183c4 5820.42 Mon. July 16, 2007
9195ddff 583 !!! Horray for mst, he fixed it !!!
584
92af7fdf 585 * Class::MOP::Package
586 - alter symbol table handling to deal with 5.8.x and 5.9.x
d7d3f3cb 587
92af7fdf 588 * t/
9195ddff 589 - Get rid of the crappy workaround from 0.40/41
92af7fdf 590
829f7554 5910.41 Sun. July 15, 2007
592 * t/
593 Arghh!!! My TODO test didn't work, so I handle
d7d3f3cb 594 it manually now so that people can use this
829f7554 595 with 5.9.5/bleadperl without issue.
596
1d7205b8 5970.40 Tues, July 3, 2007
9f88b8ff 598 * t/
d7d3f3cb 599 ~ marked a test in 003_methods.t as TODO
600 for perl 5.9.5 (this test is irrelvant to
601 the module functioning on 5.9.5 for the most
1d7205b8 602 part anyway)
9f88b8ff 603
28acb786 6040.39 Mon. June 18, 2007
b817e248 605 * Class::MOP::Immutable
0ac992ee 606 - added make_metaclass_mutable + docs (groditi)
607 - removed unused variable
d9586da2 608 - added create_immutable_transformer
609 necessary for sane overloading of immutable behavior
d7d3f3cb 610 - tests for this (groditi)
0ac992ee 611
612 * Class::MOP::Class
613 - Immutability can now be undone,
614 added make_mutable + tests + docs (groditi)
04dd7510 615 - Massive changes to the way Immutable is done
616 for details see comments next to make_immutable
617 This fixes a bug where custom metaclasses broke
d7d3f3cb 618 when made immutable. We are now keeping one immutable
619 metaclass instance per metaclass instead of just one
04dd7510 620 to prevent isa hierarchy corruption. Memory use will go
621 up, but I suspect it will be neglible.
622 - New tests added for this behavior. (groditi)
7c90a1a8 623
c0fcd6ab 6240.38 Thurs. May 31, 2007
823a5d31 625 ~~ More documentation updates ~~
d7d3f3cb 626
823a5d31 627 * Class::MOP::Package
628 - we now deal with stub methods properly
629 - added tests for this
c0fcd6ab 630 - fixed some tests failing on 5.9.5 (thanks blblack)
d7d3f3cb 631
b25109b1 632 * Class::MOP::Attribute
633 - added get_read_method and get_write_method
d7d3f3cb 634 thanks to groditi for this code, tests
c81de280 635 and docs.
b25109b1 636 - added tests and POD for this
d7d3f3cb 637
795a0c8b 638 * Class::MOP::Class
d7d3f3cb 639 - fixed RT issue #27329, clone object now
795a0c8b 640 handles undef values correctly.
641 - added tests for this
d7d3f3cb 642 - Corrected anon-class handling so that they
643 will not get reaped when instances still
644 exist which need to reference them. This is
645 the correct behavior, hopefully this is an
646 obscure enough feature that there are not too
d4ba1677 647 many work arounds out in the wild.
d7d3f3cb 648 - added tests for this by groditi
95514cb4 649 - updated docs to explain this
650
651 * metaclass
c0fcd6ab 652 - load custom metaclasses automatically (thanks groditi)
f2266181 653 - added tests for this behavior
a06797b0 654
3dc99d93 6550.37 Sat. March 10, 2007
448b6e55 656 ~~ Many, many documentation updates ~~
d7d3f3cb 657
448b6e55 658 * Class::MOP
d7d3f3cb 659 - added &load_class and &is_class_loaded
448b6e55 660 - added tests and docs for these
2367814a 661
9363ea89 662 * Class::MOP::Attribute
d7d3f3cb 663 - default now checks the instance with defined to
9363ea89 664 avoid setting off bool-overloads (found by Carl Franks)
665
c23184fc 6660.37_002
d7d3f3cb 667 * /t
668 - bad name in a test, causing meaningless failuress.
c23184fc 669 No other changes.
670
6710.37_001
d7d3f3cb 672
c23184fc 673 ~~ GLOBAL CHANGES ~~
d7d3f3cb 674 - All attribute names are now consistent and follow Perl 6
675 style (prefixed with the sigil, and ! as the twigil for
676 private attrs). This should not affect any code, unless
677 you broke encapsulation, in which case, it is your problem
c23184fc 678 anyway.
d7d3f3cb 679
c23184fc 680 !! Class::MOP::Class::Immutable has been removed
d7d3f3cb 681
c23184fc 682 * Class::MOP::Method::Constructor
d7d3f3cb 683 - this has been moved out of Class::MOP::Class::Immutable
c23184fc 684 and is a proper subclass of Class::MOP::Method now.
d7d3f3cb 685
c23184fc 686 * Class::MOP::Class
d7d3f3cb 687 - this module now uses Class::MOP::Immutable for the
688 immutable transformation instead of
c23184fc 689 Class::MOP::Class::Immutable.
d7d3f3cb 690
691 + Class::MOP::Immutable
692 - this module now controls the transformation from a mutable
693 to an immutable version of the class. Docs for this will
c23184fc 694 be coming eventually.
d7d3f3cb 695
c23184fc 696
cdc1ecba 6970.36 Sun. Nov. 5, 2006
a651e249 698 * Class::MOP::Class
d7d3f3cb 699 - added a few 'no warnings' lines to keep annoying
700 (and meaningless) warnings from chirping during
a651e249 701 global destruction.
d7d3f3cb 702
0870928c 703 * Class::MOP
d7d3f3cb 704 - some more bootstrapping is now done on the new
0870928c 705 classes
d7d3f3cb 706
0870928c 707 * Class::MOP::Class::Immutable
d7d3f3cb 708 *** API CHANGE ***
709 - constructor generation is now handled by
0870928c 710 the Class::MOP::Method::Constructor class
d7d3f3cb 711
0870928c 712 * Class::MOP::Method::Constructor
d7d3f3cb 713 - created this to handle constructor generation
0870928c 714 in Class::MOP::Class::Immutable
d7d3f3cb 715
0870928c 716 * Class::MOP::Attribute
d7d3f3cb 717 *** API CHANGE ***
718 - attributes now delegate to the
719 Class::MOP::Method::Accessor to generate
0870928c 720 accessors
d7d3f3cb 721
0870928c 722 * Class::MOP::Method::Accessor
d7d3f3cb 723 - all accessor generation functions from
0870928c 724 Class::MOP::Attribute have been moved here
a651e249 725
80f00c79 7260.35 Sat. Sept. 30, 2006
8745cf22 727
728 * scripts/class_browser.pl
d7d3f3cb 729 - initial prototype of a class browser, more
730 on this to come. Comments and patches are
8745cf22 731 very much welcome.
b1897d4d 732
733 * Class::MOP
d7d3f3cb 734 - All Class::MOP::* accessors are no longer
735 re-generated in the bootstrap, instead
6d2118a4 736 they are aliased from the originals
6d2118a4 737 - fixed tests to reflect
d7d3f3cb 738 - added Class::MOP::Method (and its subclasses)
b1897d4d 739 to the bootstrap
740 - adjusted tests for this
86482605 741 - added the Class::MOP::Instance attributes
742 to the bootstrap
d7d3f3cb 743
b1897d4d 744 * Class::MOP::Method
745 *** API CHANGE ***
746 - methods are no longer blessed CODE refs
747 but are actual objects which can be CODE-ified
748 - adjusted tests to compensate
d7d3f3cb 749 - adjusted docs for this
b1897d4d 750
751 * Class::MOP::Class
d7d3f3cb 752 - changed how methods are dealt with to
753 encapsulate most of the work into the
b1897d4d 754 &get_method_map method
755 - made several adjustments for the change
756 in Class::MOP::Method
d7d3f3cb 757 - &add_attribute now checks if you are adding
758 a duplicate name, and properly removes the
b1897d4d 759 old one before installing the new one
760 - added tests for this
86482605 761 - adjusted docs for this
d7d3f3cb 762
b1897d4d 763 * Class::MOP::Class::Immutable
764 - added caching of &get_method_map
765 - fixed issue with &get_package_symbol
766 - cleaned up the methods that die (patch by David Wheeler)
d7d3f3cb 767
b1897d4d 768 * Class::MOP::Package
d7d3f3cb 769 - added filtering capabilities to
b1897d4d 770 &list_all_package_symbols
771
a549ce50 7720.34 Sat. Aug. 26, 2006
c4260b45 773 * Class::MOP::Class
774 - added the %:methods attribute, which like
d7d3f3cb 775 the $:version and such just actually goes
776 to the symbol table to get it's stuff.
c4260b45 777 However, it makes the MOP more complete.
88dd563c 778 ** API CHANGE **
d7d3f3cb 779 - The &create method now requires that all
780 but the package name now is passed in as
88dd563c 781 named parameters. See docs for more info.
782 - updated docs and tests for this
d7d3f3cb 783
c4260b45 784 * Class::MOP::Object
d7d3f3cb 785 - added &dump method to easily Data::Dumper
c4260b45 786 an object
d7d3f3cb 787
c4260b45 788 * Class::MOP
d7d3f3cb 789 - cleaned up the initialization of attributes
790 which do not store things in the instance
c4260b45 791 - added the %:methods attribute definition to
792 the bootstrap
d7d3f3cb 793
88dd563c 794 ~ lots of misc. test cleanup
c4260b45 795
56e8dd5d 7960.33 Sat. Aug. 19, 2006
be7677c7 797 * Class::MOP::Class
d7d3f3cb 798 - moved the metaclass cache out of here
be7677c7 799 and it is now in Class::MOP itself.
d7d3f3cb 800
56e8dd5d 801 * Class::MOP
802 - moved all the metaclass cache stuff here
803 - fixed all tests for this
be7677c7 804
148b4697 805 * Class::MOP::Attribute
d7d3f3cb 806 - reference values (other than CODE refs)
148b4697 807 are no longer allowed for defaults
808 - added tests for this
d7d3f3cb 809
56dcfc1a 810 * Class::MOP::Package
d7d3f3cb 811 - fixed an issue with perl 5.8.1 and how it deals
812 with symbol tables. The namespace hash is now
813 always reloaded from the symbol table.
e3a2c885 814
815 ~ lots of misc. documentation cleanup
1396f86b 816
716c5765 8170.32 Sat. Aug. 12, 2006
d7d3f3cb 818 + added Class::MOP::Object so that the
6e57504d 819 metamodel is more complete (and closer
820 to what Perl 6 will probably be).
821
9ca19585 822 * Class::MOP::Package
d7d3f3cb 823 - refactored entire class, this is now
9ca19585 824 the primary gateway between the metaclass
825 and the Perl 5 symbol table
826 - added many tests for this
d7d3f3cb 827 - this class is now a subclass of
6e57504d 828 Class::MOP::Object
716c5765 829 - added some tests to reflect this
d7d3f3cb 830
9ca19585 831 * Class::MOP::Class
d7d3f3cb 832 - refactored all symbol table access to
9ca19585 833 use Class::MOP::Package methods instead
d7d3f3cb 834
f0480c45 835 * Class::MOP::Module
836 - adding the $:version attribute in the bootstrap
837 so that Module has a version as an attribute
838 - see comment in Class::MOP for details
d7d3f3cb 839 - added the $:authority attribute to this module
840 as well as an &identifier method, to bring us
841 ever closer to Perl 6 goodness
842 - I have added $AUTHORITY to all the modules
716c5765 843 - added tests for this
d7d3f3cb 844
f0480c45 845 * Class::MOP::Instance
d7d3f3cb 846 - added &deinitialize_slot for removing slots
f0480c45 847 from an instance
d7d3f3cb 848 - added tests for this
849
850 * Class::MOP::Attribute
9ca19585 851 - added support for &deinitialize_slot for removing
852 slots from an instance
853 - added tests for this
854
1a09d9cc 8550.31 Sat. July 15, 2006
856
b679e644 857 * Class::MOP::Class
858 - added &find_method_by_name to locate a method
d7d3f3cb 859 anywhere within the class hierarchy
860
b679e644 861 * Class::MOP::Attribute
d7d3f3cb 862 - added &set_value and &get_value for getting
863 the value of the attribute for a particular
b679e644 864 instance.
865
373a16ae 8660.30 Wed. July 5, 2006
867 ---------------------------------------
d7d3f3cb 868 This is the first version of Class::MOP
373a16ae 869 to introduce the immutable features which
d7d3f3cb 870 will be used for optimizating the MOP.
373a16ae 871 This support should still be considered
872 experimental, but moving towards stability.
873 ---------------------------------------
d7d3f3cb 874
875 * Created Class::MOP::Class::Immutable
876
877 * Created the Class::MOP::Package and
878 Class::MOP::Module classes to more
373a16ae 879 closely conform to Perl 6's meta-model
e0a82090 880
881 * Class::MOP::Class
882 - now inherits from Class::MOP::Module
d7d3f3cb 883 - several methods moved to ::Module and
e0a82090 884 ::Package and now inherited
885 - added tests for this
d7d3f3cb 886
c0cbf4d9 887 * Class::MOP::Instance
d7d3f3cb 888 - added an is_inlinable method to allow other
c0cbf4d9 889 classes to check before they attempt to optimize.
d7d3f3cb 890 - added an inline_create_instance to inline
891 instance creation (of course)
892
2ba153a9 893 ** API CHANGE **
d7d3f3cb 894 - the Class::MOP::Class::*_package_variable
2ba153a9 895 methods are all now methods of Class::MOP::Package
d7d3f3cb 896 and called *_package_symbol instead. This is
897 because they are now more general purpose symbol
898 table manipulation methods.
e0a82090 899
cdfaa4cc 9000.29_02 Thurs. June 22, 2006
901 ++ DEVELOPER RELEASE ++
df7b4119 902 * Class::MOP::Class
d7d3f3cb 903 - small change in &create so that it behaves
df7b4119 904 properly when inherited
cdfaa4cc 905 - small fix to &clone_instance
df7b4119 906
667cecf3 9070.29_01 Fri. May 12, 2006
908 ++ DEVELOPER RELEASE ++
d7d3f3cb 909 - This release works in combination with
667cecf3 910 Moose 0.09_01, it is a developer release
d7d3f3cb 911 because it introduces a new instance
912 sub-protocol and has not yet been
913 optimized.
667cecf3 914
40483095 915 * Class::MOP::Class
916 - anon-classes are now properly garbage collected
d7d3f3cb 917 - added tests for this
918 - improved method modifier wrapping
40483095 919
2bab2be6 920 * Class::MOP::Instance
1becdfcc 921 - added new instance protocol
2bab2be6 922 - added tests for this
923 - changed all relevant modules and examples
924 - Class::MOP::Class
925 - Class::MOP::Attribute
926 - examples/*
927
1becdfcc 928 * metaclass
929 - you no longer need to specify the metaclass
930 itself, if it is not there, Class::MOP::Class
931 is just assumed
932 - updated tests for this
933
934 * examples/
d7d3f3cb 935 - added ArrayBasedStorage example to show
1becdfcc 936 instance storage using ARRAY refs instead of
d7d3f3cb 937 HASH refs.
1becdfcc 938 - added tests for this
d7d3f3cb 939 - InsideOutClass is totally revised using the
1becdfcc 940 new instance protocol
941 - added more tests for this
942
93b4e576 9430.26 Mon. April 24, 2006
e7f732e4 944 * Class::MOP::Class
945 - added find_attribute_by_name method
946 - added tests and docs for this
56a0b530 947 - some small optimizations
948
949 * Class::MOP::Attribute
950 - some small optimizations
e7f732e4 951
46666f33 9520.25 Thurs. April 20, 2006
587aca23 953 * Class::MOP::Class
954 - added create_anon_class for creating anonymous classes
955 - added tests for this
956 - added get_all_metaclasses, get_all_metaclass_names
957 and get_all_metaclass_instances method to allow
958 access to all the cached metaclass objects.
bd4e03f9 959 - attribute slot initialization is now the responsibility
d7d3f3cb 960 of the attribute itself, and construct_instance now
bd4e03f9 961 delegates appropriately
d7d3f3cb 962
bd4e03f9 963 * Class::MOP::Attribute
964 - attribute slot initialization is now the responsibility
965 of the attribute itself, so we added a method for it
966 called initialize_instance_slot
d7d3f3cb 967
fed4cee7 968 * examples/
d7d3f3cb 969 - adjusted all the examples to use the new attribute
970 initialize_instance_slot method
587aca23 971
1daaa2b2 9720.24 Tues. April 11, 2006
8c936afc 973 * Class::MOP::Class
d7d3f3cb 974 - cleaned up how the before/after/around method
8c936afc 975 modifiers get named with Sub::Name
976
b9dfbf78 9770.23 Thurs. March 30, 2006
a977cf65 978 * Class::MOP::Class
d7d3f3cb 979 - fixed the way attribute defaults are handled
a977cf65 980 during instance construction (bug found by chansen)
d7d3f3cb 981
b9dfbf78 982 * Class::MOP::Attribute
d7d3f3cb 983 - read-only accessors ('reader') will now die if
b9dfbf78 984 passed more than one argument (attempting to write
985 to them basically)
986 - added tests for this
d7d3f3cb 987 - adjusted all /example files to comply
a977cf65 988
f9eba090 9890.22 Mon. March 20, 2006
0eff2c16 990 * Class::MOP::Class
991 - localized $@ in the *_package_variable functions
992 because otherwise, it does ugly things in Moose.
993 - added test case for this
994
1988e85e 9950.21 Wed. March 15, 2006
2f6d5412 996 * Class::MOP::Class
d7d3f3cb 997 - fixed issue where metaclasses are reaped from
2f6d5412 998 our cache in global destruction, and so are not
999 available in DESTORY calls
1000
96ceced8 10010.20 Thurs. March 2, 2006
d7d3f3cb 1002 - removed the dependency for Clone since
d3cb0d4a 1003 we no longer to deep-cloning by default.
d7d3f3cb 1004
a4258ffd 1005 * Class::MOP::Method
d7d3f3cb 1006 - added &package_name, &name and
1007 &fully_qualified_name methods, some of
1008 which were formerly private subs in
a4258ffd 1009 Class::MOP::Class
d7d3f3cb 1010
a4258ffd 1011 * Class::MOP::Method::Wrapped
d7d3f3cb 1012 - allows for a method to be wrapped with
1013 before, after and around modifiers
a4258ffd 1014 - added tests and docs for this feature
d3cb0d4a 1015
1016 * Class::MOP::Class
58d75218 1017 - improved &get_package_symbol
96ceced8 1018 - &version and &superclasses now use it
a4258ffd 1019 - methods are now blessed into Class::MOP::Method
1020 whenever possible
d7d3f3cb 1021 - added methods to install CLOS-style method modifiers
a4258ffd 1022 - &add_before_method_modifier
d7d3f3cb 1023 - &add_after_method_modifier
a4258ffd 1024 - &add_around_method_modifier
1025 - added tests and docs for these
d7d3f3cb 1026 - added &find_next_method_by_name which finds the
96ceced8 1027 equivalent of SUPER::method_name
d3cb0d4a 1028
1c020571 10290.12 Thurs. Feb 23, 2006
d7d3f3cb 1030 - reduced the dependency on B, no need to always
d89c0fad 1031 have the latest
1032
1c020571 1033 * examples/
1034 - added docs to the C3 method dispatch order test
d7d3f3cb 1035 - fixed missing Algorithm::C3 dependency by making
1c020571 1036 the test skip if it is not installed
1037
0dea7280 10380.11 Mon Feb. 20, 2006
f3f5bd34 1039 * examples/
1040 - added example of changing method dispatch order to C3
d7d3f3cb 1041
a27ae83f 1042 * Class::MOP::Class
19d4b5b8 1043 - changed how clone_instance behaves, it now only does a
1044 shallow clone (see docs for more details)
a27ae83f 1045 - added docs and tests
f3f5bd34 1046
3bf7644b 10470.10 Tues Feb. 14, 2006
d7d3f3cb 1048 ** This release was mostly about writing more tests and
1049 cleaning out old and dusty code, the MOP should now
3bf7644b 1050 be considered "ready to use".
1051
22286063 1052 - adding more tests to get coverage up a little higher,
1053 mostly testing errors and edge cases.
1054 - test coverage is now at 99%
d7d3f3cb 1055
aa448b16 1056 * Class::MOP
1057 - no longer optionally exports to UNIVERSAL::meta or
d7d3f3cb 1058 creates a custom metaclass generator, use the
aa448b16 1059 metaclass pragma instead.
22286063 1060
d7d3f3cb 1061 * Class::MOP::Class
1062 - fixed a number of minor issues which came up in the
1063 error/edge-case tests
1064
1065 * Class::MOP::Attribute
1066 - fixed a number of minor issues which came up in the
22286063 1067 error/edge-case tests
d7d3f3cb 1068
0b8eb325 1069 * examples/
ea263060 1070 - fixing the AttributesWithHistory example, it was broken.
663f8198 1071
550d56db 10720.06 Thurs Feb. 9, 2006
677eb158 1073 * metaclass
d7d3f3cb 1074 - adding new metaclass pragma to make setting up the
677eb158 1075 metaclass a little more straightforward
d7d3f3cb 1076
7b31baf4 1077 * Class::MOP
d7d3f3cb 1078 - clean up bootstrapping to include more complete
1079 attribute definitions for Class::MOP::Class and
1080 Class::MOP::Attribute (accessors, readers, writers,
7b31baf4 1081 etc.) ... it is redundant, but is useful meta-info
1082 to have around.
677eb158 1083
99e5b7e8 1084 * Class::MOP::Class
d7d3f3cb 1085 - fixing minor meta-circularity issue with &meta, it
99e5b7e8 1086 is now more useful for subclasses
d7d3f3cb 1087 - added &get_attribute_map as an accessor for the
7b31baf4 1088 hash of attribute meta objects
c9e77dbb 1089 - &compute_all_applicable_attributes now just returns
1090 the attribute meta-object, rather than the HASH ref
d7d3f3cb 1091 since all the same info can be gotten from the
c9e77dbb 1092 attribute meta-object itself
1093 - updated docs & tests to reflect
5f3c057a 1094 - added &clone_instance method which does a deep clone
1095 of the instance structure created by &construct_instance
1096 - added docs & tests for this
550d56db 1097 - added Clone as a dependency
5f3c057a 1098 - added &new_object and &clone_object convience methods to
1099 return blessed new or cloned instances
2a7575a6 1100 - they handle Class::MOP::Class singletons correctly too
5f3c057a 1101 - added docs & tests for this
2a7575a6 1102 - cleaned up the &constuct_class_instance so that it behaves
1103 more like &construct_instance (and managed the singletons too)
550d56db 1104 - added the &check_metaclass_compatibility method to make sure
1105 that metaclasses are upward and downward compatible.
1106 - added tests and docs for this
d7d3f3cb 1107
99e5b7e8 1108 * examples/
1109 - adjusting code to use the &Class::MOP::Class::meta
1110 fix detailed above
677eb158 1111 - adjusting code to use the metaclass pragma
d7d3f3cb 1112
aa9c883e 11130.05 Sat Feb. 4, 2006
2e41896e 1114 * Class::MOP::Class
1115 - added the &attribute_metaclass and &method_metaclass
d7d3f3cb 1116 attributes which contain a metaclass name to use for
2e41896e 1117 attributes/methods respectively
d7d3f3cb 1118
351bd7d4 1119 * Class::MOP
d7d3f3cb 1120 - bootstrap additional attributes for Class::MOP::Class
1121
2e41896e 1122 * examples/
1123 - adjusted the example code and tests to use the new
1124 &attribute_metaclass feature of Class::MOP::Class
aa9c883e 1125 - added new example:
1126 - LazyClass
2e41896e 1127
d7c2cbe3 11280.04 Fri Feb. 3, 2006
d6fbcd05 1129 * Class::MOP::Class
1130 - some documentation suggestions from #perl6
d7d3f3cb 1131
d6fbcd05 1132 * Class::MOP::Attribute
d7d3f3cb 1133 - improved error messages
1134
d6fbcd05 1135 * examples/
1136 - added new examples:
1137 - AttributesWithHistory
d7c2cbe3 1138 - ClassEncapsultedAttributes
343203ee 1139
9ec169fe 11400.03 Fri Feb. 3, 2006
1141 - converted to Module::Build instead of EU::MM
d7d3f3cb 1142
9ec169fe 1143 * Class::MOP::Attribute
1144 - refactored method generation code
1145 - attributes are now associated with class directly
d7d3f3cb 1146
f71f4295 1147 * examples/
d7d3f3cb 1148 - refactored the InsideOut example to take advantage
9ec169fe 1149 of the Class::MOP::Attribute refactoring
f71f4295 1150 - changed example files to .pod files and hide thier
1151 package names from PAUSE (I don't want to own these
1152 namespaces really, they are just examples)
9ec169fe 1153
a57c7fa2 11540.02 Thurs Feb. 2, 2006
1155 - moving examples from t/lib/* to examples/*
1156 - adding POD documentation to the examples
1157
a2e85e6c 11580.01 Thurs Feb. 2, 2006
92af7fdf 1159 - Initial release