changelog / docstring edits

Change-Id: I89be3f965d3556694f497a47a6b13247ce2a1d94

diff --git a/docs/build/unreleased/839.rst b/docs/build/unreleased/839.rst
index 85b0a482f37d64458ec655c09be3ac9920f71333..a905099a65e28fdc61b3b8c144e3b263c15b10f3 100644 (file)
--- a/docs/build/unreleased/839.rst
+++ b/docs/build/unreleased/839.rst
@@ -2,5 +2,7 @@
     :tags: bug, versioning, regression
     :tickets: 839
 
-    Fixed regression in new versioning traversal where "alembic downgrade head"
-    (or equivalent) fails instead of iterating no revisions.
+    Fixed additional regression nearly the same as that of :ticket:`838` just
+    released in 1.6.1 but within a slightly different codepath, where "alembic
+    downgrade head" (or equivalent) would fail instead of iterating no
+    revisions.

diff --git a/tests/test_version_traversal.py b/tests/test_version_traversal.py
index bdc7f658bd4f5ddcf3bbf9e2811f5bd3c2ecf2b6..0b5306d312eed4692ade660dc5c53e0ca4113273 100644 (file)
--- a/tests/test_version_traversal.py
+++ b/tests/test_version_traversal.py
@@ -54,11 +54,17 @@ class RevisionPathTest(MigrationTest):
         self._assert_downgrade("base", [], [], set())
 
     def test_downgrade_to_existing(self):
+        """test for #838; downgrade to a revision that's already in
+        current heads, but is not itself a head."""
+
         self._assert_downgrade(
             self.a.revision, [self.a.revision], [], {self.a.revision}
         )
 
     def test_downgrade_to_existing_head(self):
+        """test for #839; downgrade to a revision that's already in current
+        heads, which *is* itself a head."""
+
         self._assert_downgrade(
             self.e.revision, [self.e.revision], [], {self.e.revision}
         )