- Changed version number to 0.01000
Thomas Kratz [Thu, 8 Jun 2006 19:31:31 +0000 (19:31 +0000)]
- A few documentation fixes

lib/DBIx/Class/UUIDColumns.pm
lib/DBIx/Class/UUIDColumns/UUIDMaker.pm

index 7eca6bb..75efb8e 100644 (file)
@@ -14,9 +14,8 @@ __PACKAGE__->uuid_class( __PACKAGE__->_find_uuid_module );
 # i.e. first release of 0.XX *must* be 0.XX000. This avoids fBSD ports
 # brain damage and presumably various other packaging systems too
 
-$VERSION = '0.06002';
+$VERSION = '0.01000';
 
-# be compatible with Class::DBI::UUID
 sub uuid_columns {
     my $self = shift;
     for (@_) {
@@ -86,14 +85,17 @@ DBIx::Class::UUIDColumns - Implicit uuid columns
 
 =head1 SYNOPSIS
 
-  package Artist;
-  __PACKAGE__->load_components(qw/UUIDColumns Core DB/);
-  __PACKAGE__->uuid_columns( 'artist_id' );
+In your L<DBIx::Class> table class:
+
+  __PACKAGE__->load_components(qw/UUIDColumns ... Core/);
+  __PACKAGE__->uuid_columns('artist_id');
+
+B<Note:> The component needs to be loaded I<before> Core.
 
 =head1 DESCRIPTION
 
-This L<DBIx::Class> component resembles the behaviour of
-L<Class::DBI::UUID>, to make some columns implicitly created as uuid.
+This L<DBIx::Class> component resembles the behaviour of L<Class::DBI::UUID>,
+to make some columns implicitly created as uuid.
 
 When loaded, C<UUIDColumns> will search for a suitable uuid generation module
 from the following list of supported modules:
@@ -109,35 +111,33 @@ If no supporting module can be found, an exception will be thrown.
 *APR::UUID will not be loaded under OpenBSD due to an as yet unidentified XS
 issue.
 
-If you would like to use a specific module, you can set C<uuid_class>:
+If you would like to use a specific module, you can set L</uuid_class>:
 
   __PACKAGE__->uuid_class('::Data::UUID');
   __PACKAGE__->uuid_class('MyUUIDGenerator');
 
-Note that the component needs to be loaded before Core.
-
 =head1 METHODS
 
-=head2 uuid_columns(@columns)
+=head2 uuid_columns
 
 Takes a list of columns to be filled with uuids during insert.
 
-  __PACKAGE__->uuid_columns('id');
+  __PACKAGE__->uuid_columns('artist_id');
 
-=head2 uuid_class($classname)
+=head2 uuid_class
 
 Takes the name of a UUIDMaker subclass to be used for uuid value generation.
 This can be a fully qualified class name, or a shortcut name starting with ::
-that matches one of the available DBIx::Class::UUIDColumns::UUIDMaker subclasses:
+that matches one of the available L<DBIx::Class::UUIDColumns::UUIDMaker> subclasses:
 
   __PACKAGE__->uuid_class('CustomUUIDGenerator');
   # loads CustomeUUIDGenerator
 
-  __PACKAGE->uuid_class('::Data::UUID');
+  __PACKAGE__->uuid_class('::Data::UUID');
   # loads DBIx::Class::UUIDMaker::Data::UUID;
 
 Note that C<uuid_class> chacks to see that the specified class isa
-DBIx::Class::UUIDColumns::UUIDMaker subbclass and throws and exception if it isn't.
+L<DBIx::Class::UUIDColumns::UUIDMaker> subbclass and throws and exception if it isn't.
 
 =head2 uuid_maker
 
index a9ca80a..6cbc18d 100644 (file)
@@ -21,7 +21,7 @@ DBIx::Class::UUIDColumns::UUIDMaker - UUID wrapper module
 =head1 SYNOPSIS
 
   package CustomUUIDMaker;
-  use base qw/DBIx::Class::/;
+  use base qw/DBIx::Class::UUIDColumns::UUIDMaker/;
 
   sub as_string {
     my $uuid;
@@ -42,7 +42,7 @@ Returns the new uuid as a string.
 
 =head1 SEE ALSO
 
-L<DBIx::Class::UUIDColumns::UUIDMaker>,
+L<DBIx::Class::UUIDColumns>,
 L<DBIx::Class::UUIDColumns::UUIDMaker::UUID>,
 L<DBIx::Class::UUIDColumns::UUIDMaker::APR::UUID>,
 L<DBIx::Class::UUIDColumns::UUIDMaker::Data::UUID>,