summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBarry Warsaw2012-03-05 16:51:00 -0500
committerBarry Warsaw2012-03-05 16:51:00 -0500
commite2526bfa5cb3338ac98f101f3020b54c002252dc (patch)
treec4605e75b1ecd9d96cf84bc963ba6c2d77230cb4
parent5350f4875fbe65055d045c44cfd2d4348cfeb5ec (diff)
downloadmailman-e2526bfa5cb3338ac98f101f3020b54c002252dc.tar.gz
mailman-e2526bfa5cb3338ac98f101f3020b54c002252dc.tar.zst
mailman-e2526bfa5cb3338ac98f101f3020b54c002252dc.zip
-rw-r--r--src/mailman/database/docs/migration.rst11
-rw-r--r--src/mailman/database/schema/mm_00000000000000_base.py (renamed from src/mailman/database/schema/s_00000000000000_base.py)0
2 files changed, 6 insertions, 5 deletions
diff --git a/src/mailman/database/docs/migration.rst b/src/mailman/database/docs/migration.rst
index 930f7d245..9897b1ef2 100644
--- a/src/mailman/database/docs/migration.rst
+++ b/src/mailman/database/docs/migration.rst
@@ -8,12 +8,13 @@ features. This is supported via schema migration.
Migrations are embodied in individual Python classes, which themselves may
load SQL into the database. The naming scheme for migration files is:
- s_YYYYMMDDHHMMSS_comment.py
+ mm_YYYYMMDDHHMMSS_comment.py
where `YYYYMMDDHHMMSS` is a required numeric year, month, day, hour, minute,
and second specifier providing unique ordering for processing. Only this
-component of the file name is used to determine the ordering. (The `s_`
-prefix is required due to Python module naming requirements).
+component of the file name is used to determine the ordering. The prefix is
+required due to Python module naming requirements, but it is actually
+ignored. `mm_` is reserved for Mailman's own use.
The optional `comment` part of the file name can be used as a short
description for the migration, although comments and docstrings in the
@@ -68,7 +69,7 @@ This migration module just adds a marker to the `version` table.
>>> with open(os.path.join(path, '__init__.py'), 'w') as fp:
... pass
- >>> with open(os.path.join(path, 's_20120211000000.py'), 'w') as fp:
+ >>> with open(os.path.join(path, 'mm_20120211000000.py'), 'w') as fp:
... print >> fp, """
... from __future__ import unicode_literals
... from mailman.model.version import Version
@@ -92,7 +93,7 @@ This will load the new migration, since it hasn't been loaded before.
Migrations will only be loaded once.
- >>> with open(os.path.join(path, 's_20120211000001.py'), 'w') as fp:
+ >>> with open(os.path.join(path, 'mm_20120211000001.py'), 'w') as fp:
... print >> fp, """
... from __future__ import unicode_literals
... from mailman.model.version import Version
diff --git a/src/mailman/database/schema/s_00000000000000_base.py b/src/mailman/database/schema/mm_00000000000000_base.py
index d703088d6..d703088d6 100644
--- a/src/mailman/database/schema/s_00000000000000_base.py
+++ b/src/mailman/database/schema/mm_00000000000000_base.py