revlog: add docstring for checkinlinesize()
authorGregory Szorc <gregory.szorc@gmail.com>
Sun, 27 Sep 2015 15:31:50 -0700
changeset 26376 344a1621674b
parent 26375 3686fa2b8eee
child 26377 dfef0d3be65e
revlog: add docstring for checkinlinesize() The name is deceptive: it does more than just "check." Add a docstring to clarify what's going on.
mercurial/revlog.py
--- a/mercurial/revlog.py	Sun Sep 27 18:46:53 2015 -0700
+++ b/mercurial/revlog.py	Sun Sep 27 15:31:50 2015 -0700
@@ -1125,6 +1125,12 @@
                 % (self.indexfile, revornode))
 
     def checkinlinesize(self, tr, fp=None):
+        """Check if the revlog is too big for inline and convert if so.
+
+        This should be called after revisions are added to the revlog. If the
+        revlog has grown too large to be an inline revlog, it will convert it
+        to use multiple index and data files.
+        """
         if not self._inline or (self.start(-2) + self.length(-2)) < _maxinline:
             return