# HG changeset patch
# User Pierre-Yves David <pierre-yves.david@fb.com>
# Date 1415181615 0
# Node ID 8919dc7f2dbbfee80e41cab429d44752d5cab861
# Parent  84720eab4fbdc61879d446feef4d1b48ca00c6da
transaction: document startgroup and endgroup

These enigmatic methods are only used in repair. We document them to clarify
there purpose and user.

diff -r 84720eab4fbd -r 8919dc7f2dbb mercurial/transaction.py
--- a/mercurial/transaction.py	Wed Nov 05 09:31:57 2014 +0000
+++ b/mercurial/transaction.py	Wed Nov 05 10:00:15 2014 +0000
@@ -117,10 +117,18 @@
 
     @active
     def startgroup(self):
+        """delay registration of file entry
+
+        This is used by strip to delay vision of strip offset. The transaction
+        sees either none or all of the strip actions to be done."""
         self._queue.append(([], []))
 
     @active
     def endgroup(self):
+        """apply delayed registration of file entry.
+
+        This is used by strip to delay vision of strip offset. The transaction
+        sees either none or all of the strip actions to be done."""
         q = self._queue.pop()
         self.entries.extend(q[0])
         self._backupentries.extend(q[1])