From: Christopher Allan Webber <cwebber@dustycloud.org>
Date: Sat, 9 Jul 2011 20:10:47 +0000 (-0500)
Subject: Some instructions in the RegisterMigration docstring on how to use.
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=363fc97259bac58b8b9a933cbdf301ab6cd584b3;p=mediagoblin.git

Some instructions in the RegisterMigration docstring on how to use.
---

diff --git a/mediagoblin/db/util.py b/mediagoblin/db/util.py
index c8932755..ca1aed74 100644
--- a/mediagoblin/db/util.py
+++ b/mediagoblin/db/util.py
@@ -121,6 +121,19 @@ MIGRATIONS = {}
 class RegisterMigration(object):
     """
     Tool for registering migrations
+
+    Call like:
+
+    @RegisterMigration(33)
+    def update_dwarves(database):
+        [...]
+
+    This will register your migration with the default migration
+    registry.  Alternately, to specify a very specific
+    migration_registry, you can pass in that as the second argument.
+
+    Note, the number of your migration should NEVER be 0 or less than
+    0.  0 is the default "no migrations" state!
     """
     def __init__(self, migration_number, migration_registry=MIGRATIONS):
         self.migration_number = migration_number