mercurial/dirstate.py

--- a/mercurial/dirstate.py	Fri Jun 02 23:05:03 2017 -0700
+++ b/mercurial/dirstate.py	Sun Jun 04 16:08:50 2017 -0700
@@ -470,6 +470,12 @@
             self._pl = p
 
     def invalidate(self):
+        '''Causes the next access to reread the dirstate.
+
+        This is different from localrepo.invalidatedirstate() because it always
+        rereads the dirstate. Use localrepo.invalidatedirstate() if you want to
+        check whether the dirstate has changed before rereading it.'''
+
         for a in ("_map", "_copymap", "_filefoldmap", "_dirfoldmap", "_branch",
                   "_pl", "_dirs", "_ignore", "_nonnormalset",
                   "_otherparentset"):