lets put a doc note here for now since everyone is going to get this issue

diff --git a/alembic/script.py b/alembic/script.py
index 2ca7f2b11245b517506b06772aa842de156f6593..5598b78fd4445045203be18ed13e56b46a3975f6 100644 (file)
--- a/alembic/script.py
+++ b/alembic/script.py
@@ -267,7 +267,8 @@ class Script(object):
                 raise util.CommandError(
                         "Could not determine revision id from filename %s. "
                         "Be sure the 'revision' variable is "
-                        "declared inside the script." % filename)
+                        "declared inside the script (please see 'Upgrading "
+                        "from Alembic 0.1 to 0.2' in the documentation)." % filename)
             else:
                 revision = m.group(1)
         else: