X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FDeploymentHandler%2FHandlesVersioning.pm;fp=lib%2FDBIx%2FClass%2FDeploymentHandler%2FHandlesVersioning.pm;h=47690e6f1bb41df6a7e3b7361951027776000c59;hb=d1ae780e6916bf6637bd6ecc2b349c22487df239;hp=43f7ffb98a0354dea016a05995846114fa395242;hpb=a65184c855392d390489326e8363ffbe9a0e7fee;p=dbsrgits%2FDBIx-Class-DeploymentHandler.git

diff --git a/lib/DBIx/Class/DeploymentHandler/HandlesVersioning.pm b/lib/DBIx/Class/DeploymentHandler/HandlesVersioning.pm
index 43f7ffb..47690e6 100644
--- a/lib/DBIx/Class/DeploymentHandler/HandlesVersioning.pm
+++ b/lib/DBIx/Class/DeploymentHandler/HandlesVersioning.pm
@@ -11,13 +11,18 @@ __END__
 
 =head1 DESCRIPTION
 
-Typically a VersionHandler will take a to_version and yeild an iterator of
+Typically a VersionHandler will take a C<to_version> and yeild an iterator of
 "version sets."
 
-A "version set" is basically an arrayref of "version numbers" (which we
-already know is vague as is.)  Typically a call to a VersionHandler's
-L</next_version_set> with a db version of 1 and a "to_version" of 5 will
-iterate over something like the following:
+A "version set" could be defined as:
+
+ subtype 'Version', as 'Str';
+ subtype 'VersionSet', as 'ArrayRef[Str]';
+
+and all a "version set" does is uniquely identify a migration.
+
+Typically a call to a VersionHandler's L</next_version_set> with a C<db_version>
+of 1 and a C<to_version> of 5 will iterate over something like the following:
 
  [1, 2]
  [2, 3]
@@ -30,7 +35,7 @@ or maybe just
  [1, 5]
  undef
 
-Really how the version set's are arranged is up to the VersionHandler being
+Really how the version sets are arranged is up to the VersionHandler being
 used.
 
 In some cases users will not want versions to have inherent "previous