diff -r 1e104d8198d7 -r 038f4f0439d7 mercurial/localrepo.py
--- a/mercurial/localrepo.py	Wed Aug 29 21:26:39 2012 +0200
+++ b/mercurial/localrepo.py	Thu Aug 30 22:13:24 2012 +0200
@@ -306,6 +306,8 @@
         Note that the hiddenrevs will needs invalidations when
         - a new changesets is added (possible unstable above extinct)
         - a new obsolete marker is added (possible new extinct changeset)
+
+        hidden changesets cannot have non-hidden descendants
         """
         hidden = set()
         if self.obsstore: