various pod fixes
[dbsrgits/DBIx-Class-DeploymentHandler.git] / lib / DBIx / Class / DeploymentHandler.pm
index d679d5b..1a21ff2 100644 (file)
@@ -1,5 +1,7 @@
 package DBIx::Class::DeploymentHandler;
 
+# ABSTRACT: Extensible DBIx::Class deployment
+
 use Moose;
 
 extends 'DBIx::Class::DeploymentHandler::Dad';
@@ -30,9 +32,11 @@ __PACKAGE__->meta->make_immutable;
 
 1;
 
+#vim: ts=2 sw=2 expandtab
+
 __END__
 
-=SYNOPSIS
+=head1 SYNOPSIS
 
  use aliased 'DBIx::Class::DeploymentHandler' => 'DH';
  my $s = My::Schema->connect(...);
@@ -79,8 +83,6 @@ with):
 
 =over
 
-=over
-
 =item *
 
 Downgrades in addition to upgrades.
@@ -133,4 +135,17 @@ of the tables
 
 Install the version storage and not the rest of the tables
 
-vim: ts=2 sw=2 expandtab
+=head1 THIS SUCKS
+
+You started your project and weren't using DBICDH?  FOOL!  Lucky for you I had
+you in mind when I wrote this doc <3
+
+First off, you'll want to just install the version_storage:
+
+ my $s = My::Schema->connect(...);
+ my $dh = DeployHandler({ schema => $s });
+
+ $dh->prepare_version_storage_install;
+ $dh->install_version_storage;
+
+Then, bump your schema version, and you can use DBICDH like normal!