Add first and last

[gitmo/Moose-Autobox.git] / lib / Moose / Autobox / Scalar.pm

diff --git a/lib/Moose/Autobox/Scalar.pm b/lib/Moose/Autobox/Scalar.pm
index ca80a79..6ebb9fe 100644 (file)
--- a/lib/Moose/Autobox/Scalar.pm
+++ b/lib/Moose/Autobox/Scalar.pm
@@ -1,15 +1,16 @@
 package Moose::Autobox::Scalar;
 use Moose::Role 'with';
 
-our $VERSION = '0.01';
+our $VERSION = '0.10';
 
 with 'Moose::Autobox::String',
      'Moose::Autobox::Number';     
 
-# ::Value requirement     
-     
-sub print { CORE::print $_[0] }  
-     
+sub flatten { $_[0] }
+sub first { $_[0] }
+sub last  { $_[0] }
+sub print { CORE::print $_[0] }
+sub say   { CORE::print $_[0], "\n" }
 1;
 
 __END__
@@ -20,12 +21,39 @@ __END__
 
 Moose::Autobox::Scalar - the Scalar role
 
-=head1 SYNOPOSIS
+=head1 DESCRIPTION
 
-  use Moose::Autobox;
-  use autobox;
+This is a role to describes a Scalar value, which is defined 
+as the combination (union sort of) of a String and a Number.
 
-=head1 DESCRIPTION
+=head1 METHODS
+
+=over 4
+
+=item B<meta>
+
+=item B<print>
+
+=item B<say>
+
+=item B<flatten>
+
+Flattening a scalar just returns the scalar.  This means that you can say:
+
+  my @array = $input->flatten;
+
+  # Given $input of 5, @array is (5);
+  # Given $input of [ 5, 2, 0], @array is (5, 2, 0)
+
+=back
+
+=item B<first>
+
+As per flatten.
+
+=item B<last>
+
+As per flatten.
 
 =head1 BUGS
 
@@ -39,11 +67,11 @@ Stevan Little E<lt>stevan@iinteractive.comE<gt>
 
 =head1 COPYRIGHT AND LICENSE
 
-Copyright 2006 by Infinity Interactive, Inc.
+Copyright 2006-2008 by Infinity Interactive, Inc.
 
 L<http://www.iinteractive.com>
 
 This library is free software; you can redistribute it and/or modify
 it under the same terms as Perl itself.
 
-=cut
\ No newline at end of file
+=cut