Class::MOP fixes
[gitmo/Class-MOP.git] / Changes
1 Revision history for Perl extension Class-MOP.
2
3 0.54
4     * Class::MOP
5       metaclass
6       - making sure that load_class never gets
7         passed a value from @_ or $_ to squash 
8         Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
9
10     * Class::MOP::Class
11       - make_{immutable,mutable} now return 1
12         (cause Sartak asked)
13       - improved error handling in ->create method
14         
15     * Class::MOP::Object
16       - localizing the Data::Dumper configurations so 
17         that it does not pollute others (RT #33509)        
18  
19     * Class::MOP::Class
20       Class::MOP::Package
21       Class::MOP::Module
22       Class::MOP::Method
23       Class::MOP::Attribute
24       - these classes no longer define their own ->meta, 
25         but instead just inherit from Class::MOP::Object      
26       
27     * Class::MOP::Instance
28       Class::MOP::Immutable                        
29       - these classes now inherit from Class::MOP::Object
30  
31     * t/
32       - fixed the filename length on several 
33         test files so we install on VMS better
34         (RT #32295)
35       - fixed incorrect use of catdir when it 
36         should be catfile (RT #32385)
37
38 0.53 Thurs. Feb. 14, 1008
39     ~~ several doc. fixes and updates ~~
40         
41     * Class::MOP::Class
42       Class::MOP::Method::Constructor
43       Class::MOP::Attribute
44         - making init_arg accept an undefined value
45           to indicate that no constructor args can 
46           be passed (thanks to nothingmuch)
47           - added tests for this
48         - added attribute initializer attribute (rjbs)
49           
50     * Class::MOP.
51         - making this use the new init_arg => undef
52           feature instead of the silly hack from 
53           before (thanks to nothingmuch)
54
55 0.52 Tues. Jan. 22, 2008
56     * Class::MOP::Class
57       - fixed bug in rebless_instance 
58         (discovered by ash)
59
60     * Class::MOP::Method::Constructor
61       - removed assumptions about the existence of 
62         a &meta method
63
64 0.51 Mon. Jan. 14, 2008
65     ~~~ some misc. doc. fixes ~~~
66     ~~ updated copyright dates ~~
67     
68     * Class::MOP
69       - now sets the IS_RUNNING_ON_5_10 
70         constant so that we can take advantage
71         of some of the nice bits of 5.10
72     
73     * Class::MOP::Class
74       - uses the IS_RUNNING_ON_5_10 flag to 
75         optimize the &linearized_isa method 
76         and avoid the hack/check for circular
77         inheritence in &class_precedence_list 
78       - added rebless_instance method (Sartak)
79         - added tests for this
80     
81     * Class::MOP::Immutable 
82       - the immutable class now keeps track of 
83         the transformer which immutablized it
84
85     * Class::MOP::Instance
86       - added rebless_instance_structure method (Sartak)
87         - added tests for this
88
89 0.50 Fri. Dec. 21, 2007
90     * Class::MOP::Class
91       - fixed bug in immutable to make sure that 
92         transformation arguments are saved 
93         correctly (mst)
94         - added tests for this
95         
96     * Class::MOP::Immutable
97       - fixed a bug (see above)
98       
99     * Class::MOP::Attribute
100       - some doc updates
101
102 0.49 Fri. Dec. 14, 2007
103     !! Class::MOP now loads 2 x faster  !!
104     !! with XS speedups (thanks konobi) !!
105         
106     * Class::MOP
107       - removed the dependency on B
108       - added two XS functions (thanks konobi)
109         - get_code_info($code) which replaces all
110           the B fiddling we were doing with
111           faster/leaner XS level fiddling
112         - check_package_cache_flag($pkg_name) which 
113           returns the PL_sub_generation variable to 
114           be used to help manage method caching.
115           
116           NOTE: 
117           In 5.10 or greater this will actually 
118           use the mro::get_pkg_gen instead to give 
119           even more accurate caching information. 
120           blblack++ for that stuff :)
121           
122     * Class::MOP::Class
123       - added the &subclasses method (thanks rlb)
124       - added the update_package_cache_flag and 
125         reset_package_cache_flag which help keep 
126         track of when we need to re-fetch the 
127         method map. 
128       - Several small improvements to take advantage
129         of the new method map caching features
130
131 0.48 Mon. Nov. 26, 2007
132     * Class::MOP::Attribute
133       - fixed get_read/write_method to handle the 
134         HASH ref case, which makes the 
135         get_read/write_method_ref handle it too.
136         - added more tests for this
137
138 0.47 Sat. Nov. 24, 2007
139     * Class::MOP::Attribute
140       - fixed misspelling in get_write_method_ref
141         - added more tests for this
142
143 0.46 Fri. Nov. 23, 2007
144     * Class::MOP::Class
145       - added the linearized_isa method instead of constantly 
146         pruning duplicate classes (this will be even more 
147         useful in the 5.10-compat version coming soon)
148     
149     * Class::MOP::Attribute
150       - added the get_read_method_ref and get_write_method_ref
151         methods which allow you to retrieve a CODE ref which 
152         can always be used to read or write an attribute.
153
154 0.45 Thurs. Nov. 13, 2007
155     * Class::MOP::Attribute
156       - Fix error message on confess (groditi)
157
158 0.44 Thurs. Nov. 13, 2007
159     - Apparently I didn't make dist correctly (groditi)
160
161 0.43 Thurs. Nov. 13, 2007
162     * Class::MOP
163       - Add support for the 'builder' attribute (groditi)
164
165     * Class::MOP::Class
166       - optimise metaclass-already-exists check in 
167         construct_class_instance (groditi)
168       - duplicate check into initialize to save a 
169         call through (groditi)
170
171     * Class::MOP::Attribute
172       - Add support for the 'builder' attribute (groditi)
173       - Make predicates check for the existence of a value, not whether 
174         it is defined (groditi)
175
176     * Class::MOP::Instance
177       - Make predicates check for the existence of a value, not whether 
178         it is defined (groditi)
179
180     * Class::MOP::Method::Accessor 
181       - made this a subclass of Class::MOP::Method::Generated
182         - removed the relevant attributes
183
184     * Class::MOP::Method::Constructor
185       - fixed the cached values we had to be more sane
186       - made this a subclass of Class::MOP::Method::Generated
187       - fixed generated constructor so it properly handles 
188         subclasses now.
189         - added tests for this
190       - added the option to allow for both inlined and 
191         non-inlined constructors.
192       - Update inlined methods for builder and predicate changes (groditi)
193
194     * Class::MOP::Method::Generated
195       - added this class as an abstract base for the 
196         Class::MOP::Method::{Constructor,Accessor} classes
197         - added tests for this
198
199     *t/
200       - Alter tests (005, 014 020, 021) for new builder addition (groditi)
201       - Tests for new predicate behavior (and corrections to old tests) (groditi)
202
203     *examples/
204       - Update ArrayRef based class example to work with predicate changes
205
206 0.42 Mon. July 16, 2007
207     !!! Horray for mst, he fixed it !!!
208
209     * Class::MOP::Package
210       - alter symbol table handling to deal with 5.8.x and 5.9.x
211       
212     * t/
213       - Get rid of the crappy workaround from 0.40/41
214
215 0.41 Sun. July 15, 2007
216     * t/
217         Arghh!!! My TODO test didn't work, so I handle
218         it manually now so that people can use this 
219         with 5.9.5/bleadperl without issue.
220
221 0.40 Tues, July 3, 2007
222     * t/
223       ~ marked a test in 003_methods.t as TODO 
224         for perl 5.9.5 (this test is irrelvant to 
225         the module functioning on 5.9.5 for the most 
226         part anyway)
227
228 0.39 Mon. June 18, 2007
229     * Class::MOP::Immutable
230       - added make_metaclass_mutable + docs (groditi)
231       - removed unused variable
232       - added create_immutable_transformer
233         necessary for sane overloading of immutable behavior
234          - tests for this (groditi) 
235
236     * Class::MOP::Class
237       - Immutability can now be undone,
238         added make_mutable + tests + docs (groditi)
239       - Massive changes to the way Immutable is done
240         for details see comments next to make_immutable
241         This fixes a bug where custom metaclasses broke
242         when made immutable. We are now keeping one immutable 
243         metaclass instance per metaclass instead of just one 
244         to prevent isa hierarchy corruption. Memory use will go
245         up, but I suspect it will be neglible.
246          - New tests added for this behavior.  (groditi)
247
248 0.38 Thurs. May 31, 2007
249     ~~ More documentation updates ~~
250     
251     * Class::MOP::Package
252       - we now deal with stub methods properly
253         - added tests for this
254       - fixed some tests failing on 5.9.5 (thanks blblack)
255         
256     * Class::MOP::Attribute
257       - added get_read_method and get_write_method
258         thanks to groditi for this code, tests 
259         and docs.
260         - added tests and POD for this
261     
262     * Class::MOP::Class
263       - fixed RT issue #27329, clone object now 
264         handles undef values correctly.
265         - added tests for this
266       - Corrected anon-class handling so that they 
267         will not get reaped when instances still 
268         exist which need to reference them. This is 
269         the correct behavior, hopefully this is an 
270         obscure enough feature that there are not too 
271         many work arounds out in the wild.
272         - added tests for this by groditi   
273         - updated docs to explain this
274
275     * metaclass
276       - load custom metaclasses automatically (thanks groditi)
277         - added tests for this behavior
278
279 0.37 Sat. March 10, 2007
280     ~~ Many, many documentation updates ~~
281     
282     * Class::MOP
283       - added &load_class and &is_class_loaded 
284         - added tests and docs for these
285
286     * Class::MOP::Attribute
287       - default now checks the instance with defined to 
288         avoid setting off bool-overloads (found by Carl Franks)
289
290 0.37_002
291     * /t 
292       - bad name in a test, causing meaningless failuress. 
293         No other changes.
294
295 0.37_001
296     
297     ~~ GLOBAL CHANGES ~~
298     - All attribute names are now consistent and follow Perl 6 
299       style (prefixed with the sigil, and ! as the twigil for 
300       private attrs). This should not affect any code, unless 
301       you broke encapsulation, in which case, it is your problem 
302       anyway.
303       
304     !! Class::MOP::Class::Immutable has been removed
305     
306     * Class::MOP::Method::Constructor
307       - this has been moved out of Class::MOP::Class::Immutable 
308         and is a proper subclass of Class::MOP::Method now.
309         
310     * Class::MOP::Class
311       - this module now uses Class::MOP::Immutable for the 
312         immutable transformation instead of 
313         Class::MOP::Class::Immutable.
314         
315     + Class::MOP::Immutable 
316       - this module now controls the transformation from a mutable 
317         to an immutable version of the class. Docs for this will 
318         be coming eventually.
319     
320
321 0.36 Sun. Nov. 5, 2006
322     * Class::MOP::Class
323       - added a few 'no warnings' lines to keep annoying 
324         (and meaningless) warnings from chirping during 
325         global destruction.
326           
327     * Class::MOP
328       - some more bootstrapping is now done on the new 
329         classes
330     
331     * Class::MOP::Class::Immutable
332       *** API CHANGE ***    
333       - constructor generation is now handled by 
334         the Class::MOP::Method::Constructor class
335      
336     * Class::MOP::Method::Constructor
337       - created this to handle constructor generation 
338         in Class::MOP::Class::Immutable
339     
340     * Class::MOP::Attribute
341       *** API CHANGE ***    
342       - attributes now delegate to the 
343         Class::MOP::Method::Accessor to generate 
344         accessors
345     
346     * Class::MOP::Method::Accessor
347       - all accessor generation functions from 
348         Class::MOP::Attribute have been moved here
349
350 0.35 Sat. Sept. 30, 2006
351
352     * scripts/class_browser.pl
353       - initial prototype of a class browser, more 
354         on this to come. Comments and patches are 
355         very much welcome.
356
357     * Class::MOP
358       - All Class::MOP::* accessors are no longer 
359         re-generated in the bootstrap, instead 
360         they are aliased from the originals
361         - fixed tests to reflect
362       - added Class::MOP::Method (and its subclasses) 
363         to the bootstrap
364         - adjusted tests for this
365       - added the Class::MOP::Instance attributes
366         to the bootstrap
367     
368     * Class::MOP::Method
369       *** API CHANGE ***
370       - methods are no longer blessed CODE refs
371         but are actual objects which can be CODE-ified
372         - adjusted tests to compensate
373         - adjusted docs for this        
374
375     * Class::MOP::Class
376       - changed how methods are dealt with to 
377         encapsulate most of the work into the 
378         &get_method_map method
379       - made several adjustments for the change
380         in Class::MOP::Method
381       - &add_attribute now checks if you are adding 
382         a duplicate name, and properly removes the 
383         old one before installing the new one
384         - added tests for this
385         - adjusted docs for this
386     
387     * Class::MOP::Class::Immutable
388       - added caching of &get_method_map
389       - fixed issue with &get_package_symbol
390       - cleaned up the methods that die (patch by David Wheeler)
391     
392     * Class::MOP::Package
393       - added filtering capabilities to 
394         &list_all_package_symbols
395
396 0.34 Sat. Aug. 26, 2006
397     * Class::MOP::Class
398       - added the %:methods attribute, which like
399         the $:version and such just actually goes 
400         to the symbol table to get it's stuff. 
401         However, it makes the MOP more complete.
402      ** API CHANGE **
403       - The &create method now requires that all 
404         but the package name now is passed in as 
405         named parameters. See docs for more info.
406         - updated docs and tests for this
407         
408     * Class::MOP::Object
409       - added &dump method to easily Data::Dumper 
410         an object
411         
412     * Class::MOP
413       - cleaned up the initialization of attributes 
414         which do not store things in the instance 
415       - added the %:methods attribute definition to
416         the bootstrap
417         
418     ~ lots of misc. test cleanup
419
420 0.33 Sat. Aug. 19, 2006
421     * Class::MOP::Class
422       - moved the metaclass cache out of here 
423         and it is now in Class::MOP itself.
424         
425     * Class::MOP
426       - moved all the metaclass cache stuff here
427         - fixed all tests for this
428
429     * Class::MOP::Attribute
430       - reference values (other than CODE refs) 
431         are no longer allowed for defaults
432         - added tests for this
433     
434     * Class::MOP::Package
435       - fixed an issue with perl 5.8.1 and how it deals 
436         with symbol tables. The namespace hash is now 
437         always reloaded from the symbol table. 
438
439     ~ lots of misc. documentation cleanup
440
441 0.32 Sat. Aug. 12, 2006
442     + added Class::MOP::Object so that the 
443       metamodel is more complete (and closer
444       to what Perl 6 will probably be).
445
446     * Class::MOP::Package
447       - refactored entire class, this is now 
448         the primary gateway between the metaclass
449         and the Perl 5 symbol table
450         - added many tests for this
451       - this class is now a subclass of 
452         Class::MOP::Object
453         - added some tests to reflect this
454         
455     * Class::MOP::Class
456       - refactored all symbol table access to 
457         use Class::MOP::Package methods instead
458         
459     * Class::MOP::Module
460       - adding the $:version attribute in the bootstrap
461         so that Module has a version as an attribute
462         - see comment in Class::MOP for details
463       - added the $:authority attribute to this module 
464         as well as an &identifier method, to bring us 
465         ever closer to Perl 6 goodness 
466         - I have added $AUTHORITY to all the modules 
467         - added tests for this
468       
469     * Class::MOP::Instance
470       - added &deinitialize_slot for removing slots 
471         from an instance
472         - added tests for this      
473       
474     * Class::MOP::Attribute 
475       - added support for &deinitialize_slot for removing
476         slots from an instance
477         - added tests for this
478
479 0.31 Sat. July 15, 2006
480
481     * Class::MOP::Class
482       - added &find_method_by_name to locate a method
483         anywhere within the class hierarchy   
484         
485     * Class::MOP::Attribute
486       - added &set_value and &get_value for getting 
487         the value of the attribute for a particular 
488         instance.
489
490 0.30 Wed. July 5, 2006
491     ---------------------------------------
492     This is the first version of Class::MOP 
493     to introduce the immutable features which
494     will be used for optimizating the MOP. 
495     This support should still be considered
496     experimental, but moving towards stability.
497     ---------------------------------------
498     
499     * Created Class::MOP::Class::Immutable  
500     
501     * Created the Class::MOP::Package and 
502       Class::MOP::Module classes to more 
503       closely conform to Perl 6's meta-model
504
505     * Class::MOP::Class
506       - now inherits from Class::MOP::Module
507       - several methods moved to ::Module and 
508         ::Package and now inherited
509         - added tests for this
510       
511     * Class::MOP::Instance
512       - added an is_inlinable method to allow other 
513         classes to check before they attempt to optimize.
514       - added an inline_create_instance to inline 
515         instance creation (of course) 
516         
517     ** API CHANGE **
518       - the Class::MOP::Class::*_package_variable 
519         methods are all now methods of Class::MOP::Package
520         and called *_package_symbol instead. This is 
521         because they are now more general purpose symbol 
522         table manipulation methods.        
523
524 0.29_02 Thurs. June 22, 2006
525     ++ DEVELOPER RELEASE ++
526     * Class::MOP::Class
527       - small change in &create so that it behaves 
528         properly when inherited
529       - small fix to &clone_instance
530
531 0.29_01 Fri. May 12, 2006
532     ++ DEVELOPER RELEASE ++
533       - This release works in combination with 
534         Moose 0.09_01, it is a developer release
535         because it introduces a new instance 
536         sub-protocol and has not yet been 
537         optimized.  
538
539     * Class::MOP::Class
540       - anon-classes are now properly garbage collected
541         - added tests for this 
542       - improved method modifier wrapping 
543
544     * Class::MOP::Instance
545       - added new instance protocol
546         - added tests for this
547       - changed all relevant modules and examples
548         - Class::MOP::Class
549         - Class::MOP::Attribute
550         - examples/*
551
552     * metaclass
553       - you no longer need to specify the metaclass
554         itself, if it is not there, Class::MOP::Class
555         is just assumed
556         - updated tests for this
557
558     * examples/
559       - added ArrayBasedStorage example to show 
560         instance storage using ARRAY refs instead of
561         HASH refs. 
562         - added tests for this
563       - InsideOutClass is totally revised using the 
564         new instance protocol
565         - added more tests for this
566
567 0.26 Mon. April 24, 2006
568     * Class::MOP::Class
569       - added find_attribute_by_name method
570         - added tests and docs for this
571       - some small optimizations
572
573     * Class::MOP::Attribute
574       - some small optimizations
575
576 0.25 Thurs. April 20, 2006
577     * Class::MOP::Class
578       - added create_anon_class for creating anonymous classes
579         - added tests for this
580       - added get_all_metaclasses, get_all_metaclass_names
581         and get_all_metaclass_instances method to allow
582         access to all the cached metaclass objects.
583       - attribute slot initialization is now the responsibility
584         of the attribute itself, and construct_instance now 
585         delegates appropriately
586         
587     * Class::MOP::Attribute
588       - attribute slot initialization is now the responsibility
589         of the attribute itself, so we added a method for it
590         called initialize_instance_slot
591     
592     * examples/
593       - adjusted all the examples to use the new attribute 
594         initialize_instance_slot method 
595
596 0.24 Tues. April 11, 2006
597     * Class::MOP::Class
598       - cleaned up how the before/after/around method 
599         modifiers get named with Sub::Name
600
601 0.23 Thurs. March 30, 2006
602         * Class::MOP::Class
603           - fixed the way attribute defaults are handled 
604             during instance construction (bug found by chansen)
605             
606         * Class::MOP::Attribute
607           - read-only accessors ('reader') will now die if 
608             passed more than one argument (attempting to write
609             to them basically)
610               - added tests for this
611               - adjusted all /example files to comply 
612
613 0.22 Mon. March 20, 2006
614     * Class::MOP::Class
615       - localized $@ in the *_package_variable functions
616         because otherwise, it does ugly things in Moose.
617           - added test case for this
618
619 0.21 Wed. March 15, 2006
620     * Class::MOP::Class
621       - fixed issue where metaclasses are reaped from 
622         our cache in global destruction, and so are not
623         available in DESTORY calls
624
625 0.20 Thurs. March 2, 2006
626     - removed the dependency for Clone since 
627       we no longer to deep-cloning by default.
628     
629     * Class::MOP::Method
630       - added &package_name, &name and 
631         &fully_qualified_name methods, some of 
632         which were formerly private subs in 
633         Class::MOP::Class
634       
635     * Class::MOP::Method::Wrapped
636       - allows for a method to be wrapped with 
637         before, after and around modifiers 
638           - added tests and docs for this feature
639
640     * Class::MOP::Class
641       - improved &get_package_symbol
642           - &version and &superclasses now use it
643       - methods are now blessed into Class::MOP::Method
644         whenever possible
645       - added methods to install CLOS-style method modifiers 
646          - &add_before_method_modifier
647          - &add_after_method_modifier         
648          - &add_around_method_modifier
649              - added tests and docs for these
650       - added &find_next_method_by_name which finds the 
651         equivalent of SUPER::method_name
652
653 0.12 Thurs. Feb 23, 2006
654     - reduced the dependency on B, no need to always 
655       have the latest
656
657     * examples/
658       - added docs to the C3 method dispatch order test
659       - fixed missing Algorithm::C3 dependency by making 
660         the test skip if it is not installed
661
662 0.11 Mon Feb. 20, 2006
663     * examples/
664       - added example of changing method dispatch order to C3
665       
666     * Class::MOP::Class
667       - changed how clone_instance behaves, it now only does a
668         shallow clone (see docs for more details)
669         - added docs and tests
670
671 0.10 Tues Feb. 14, 2006
672     ** This release was mostly about writing more tests and 
673        cleaning out old and dusty code, the MOP should now 
674        be considered "ready to use".
675
676     - adding more tests to get coverage up a little higher,
677       mostly testing errors and edge cases.
678       - test coverage is now at 99%
679       
680     * Class::MOP
681       - no longer optionally exports to UNIVERSAL::meta or
682         creates a custom metaclass generator, use the 
683         metaclass pragma instead.
684
685     * Class::MOP::Class  
686       - fixed a number of minor issues which came up in the 
687         error/edge-case tests
688         
689     * Class::MOP::Attribute 
690       - fixed a number of minor issues which came up in the 
691         error/edge-case tests        
692      
693     * examples/
694       - fixing the AttributesWithHistory example, it was broken.
695
696 0.06 Thurs Feb. 9, 2006
697     * metaclass
698       - adding new metaclass pragma to make setting up the 
699         metaclass a little more straightforward
700         
701     * Class::MOP
702       - clean up bootstrapping to include more complete 
703         attribute definitions for Class::MOP::Class and 
704         Class::MOP::Attribute (accessors, readers, writers, 
705         etc.) ... it is redundant, but is useful meta-info
706         to have around.
707
708     * Class::MOP::Class
709       - fixing minor meta-circularity issue with &meta, it 
710         is now more useful for subclasses
711       - added &get_attribute_map as an accessor for the 
712         hash of attribute meta objects
713       - &compute_all_applicable_attributes now just returns
714         the attribute meta-object, rather than the HASH ref
715         since all the same info can be gotten from the 
716         attribute meta-object itself
717           - updated docs & tests to reflect
718       - added &clone_instance method which does a deep clone
719         of the instance structure created by &construct_instance
720           - added docs & tests for this
721           - added Clone as a dependency
722       - added &new_object and &clone_object convience methods to
723         return blessed new or cloned instances
724           - they handle Class::MOP::Class singletons correctly too
725           - added docs & tests for this
726       - cleaned up the &constuct_class_instance so that it behaves
727         more like &construct_instance (and managed the singletons too)
728       - added the &check_metaclass_compatibility method to make sure
729         that metaclasses are upward and downward compatible.
730           - added tests and docs for this
731           
732     * examples/
733       - adjusting code to use the &Class::MOP::Class::meta
734         fix detailed above
735       - adjusting code to use the metaclass pragma
736       
737 0.05 Sat Feb. 4, 2006
738     * Class::MOP::Class
739       - added the &attribute_metaclass and &method_metaclass
740         attributes which contain a metaclass name to use for 
741         attributes/methods respectively
742     
743     * Class::MOP
744       - bootstrap additional attributes for Class::MOP::Class 
745         
746     * examples/
747       - adjusted the example code and tests to use the new
748         &attribute_metaclass feature of Class::MOP::Class
749       - added new example:
750         - LazyClass
751
752 0.04 Fri Feb. 3, 2006
753     * Class::MOP::Class
754       - some documentation suggestions from #perl6
755     
756     * Class::MOP::Attribute
757       - improved error messages    
758     
759     * examples/
760       - added new examples:
761         - AttributesWithHistory
762         - ClassEncapsultedAttributes
763
764 0.03 Fri Feb. 3, 2006
765     - converted to Module::Build instead of EU::MM
766     
767     * Class::MOP::Attribute
768       - refactored method generation code
769       - attributes are now associated with class directly
770     
771     * examples/
772       - refactored the InsideOut example to take advantage 
773         of the Class::MOP::Attribute refactoring
774       - changed example files to .pod files and hide thier
775         package names from PAUSE (I don't want to own these
776         namespaces really, they are just examples)
777
778 0.02 Thurs Feb. 2, 2006
779     - moving examples from t/lib/* to examples/*
780         - adding POD documentation to the examples
781
782 0.01 Thurs Feb. 2, 2006
783     - Initial release