adding docs

diff --git a/Changes b/Changes
index 77f9f78..d69860b 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,5 +1,10 @@
 Revision history for Perl extension Moose::Autobox
 
+0.07
+    * Moose::Autobox
+      - added documentation about how to extend the autoboxed
+        types (RT #34315)
+
 0.06 Tues. Jan. 22, 2008
     ~~ updated copyright dates & some docs ~~   
 

diff --git a/README b/README
index be02c0e..e21ab3e 100644 (file)
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-Moose::Autobox version 0.06
+Moose::Autobox version 0.07
 ===========================
 
 See the individual module documentation for more information

diff --git a/lib/Moose/Autobox.pm b/lib/Moose/Autobox.pm
index fd64057..7ec3dc3 100644 (file)
--- a/lib/Moose/Autobox.pm
+++ b/lib/Moose/Autobox.pm
@@ -8,7 +8,7 @@ use Carp        qw(confess);
 use Scalar::Util ();
 use Moose::Util  ();
 
-our $VERSION = '0.06';
+our $VERSION = '0.07';
 
 use base 'autobox';
 
@@ -116,6 +116,21 @@ hit, but as I am fond of saying, nothing in life is free. If you have
 any questions regarding this module, either email me, or stop by #moose
 on irc.perl.org and ask around.
 
+=head2 Adding additional methods
+
+B<Moose::Autobox> asks L<autobox> to use the B<Moose::Autobox::*> namespace 
+prefix so as to avoid stepping on the toes of other L<autobox> modules. This 
+means that if you want to add methods to a particular perl type 
+(i.e. - monkeypatch), then you must do this:
+
+  sub Moose::Autobox::SCALAR::bar { 42 }
+
+instead of this:
+
+  sub SCALAR::bar { 42 
+
+as you would with vanilla autobox.
+
 =head1 METHODS
 
 =over 4