[Bast-commits] r9227 - DBIx-Class-Journal/1.000/trunk/lib/DBIx/Class

[oliver at dev.catalyst.perl.org]

Author: oliver
Date: 2010-04-26 23:05:59 +0100 (Mon, 26 Apr 2010)
New Revision: 9227

Modified:
   DBIx-Class-Journal/1.000/trunk/lib/DBIx/Class/Journal.pm
Log:
added a small amount of POD, but I need to go walk the dog now

Modified: DBIx-Class-Journal/1.000/trunk/lib/DBIx/Class/Journal.pm
===================================================================
--- DBIx-Class-Journal/1.000/trunk/lib/DBIx/Class/Journal.pm	2010-04-26 21:20:20 UTC (rev 9226)
+++ DBIx-Class-Journal/1.000/trunk/lib/DBIx/Class/Journal.pm	2010-04-26 22:05:59 UTC (rev 9227)
@@ -73,7 +73,7 @@
 
 =head1 NAME
 
-DBIx::Class::Journal - auditing for tables managed by DBIx::Class
+DBIx::Class::Journal - Auditing for tables managed by DBIx::Class
 
 =head1 SYNOPSIS
 
@@ -82,6 +82,12 @@
 
  __PACKAGE__->load_components(qw/Schema::Journal/);
 
+And then call C<< $schema->journal_schema_deploy >> to create all the tables
+necessary for the journal, in your database.
+
+Optionally set where the journal is stored, and associate a user ID with
+each changeset.
+
  __PACKAGE__->journal_connection(['dbi:SQLite:t/var/Audit.db']);
  __PACKAGE__->journal_user(['My::Schema::User', {'foreign.userid' => 'self.user_id'}]);
 
@@ -170,9 +176,8 @@
 =item journal_components @components
 
 If you want to add components to your journal
-(L<DBIx::Class::Schema::Versioned> for example) this would be the
+(L<DBIx::Class::Schema::Versioned> for example) pass them here.
 
-
 =item journal_sources \@source_names
 
 Set a list of source names you would like to audit, if unset, all
@@ -192,12 +197,17 @@
 with a belongs_to relation, if this is set with the appropriate
 arguments.
 
+=item journal_schema_deploy
+
+Will use L<DBIx::Class::Schema/deploy> to set up the tables for
+journalling in your schema. Use this method to set up your journal.
+
 =item journal_deploy_on_connect $bool
 
 If set to a true value will cause C<journal_schema_deploy> to be called on
 C<connect>.
 
-Not reccomended, but present for backwards compatibility.
+Not recommended, but present for backwards compatibility.
 
 =item changeset_user $user_id
 
@@ -207,6 +217,11 @@
 
 Set the session_id for the following changeset(s). This must be an integer.
 
+=item deploy
+
+Overloaded L<DBIx::Class::Schema/deploy> which will deploy your primary
+database schema and following that will deploy the journal schema.
+
 =item txn_do $code_ref, @args
 
 Overloaded L<DBIx::Class::Schema/txn_do>, this must be used to start a