comparison mercurial/transaction.py @ 23250:8919dc7f2dbb

transaction: document startgroup and endgroup

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

23249:84720eab4fbd

        if self.journal:
            self._abort()

    @active
    def startgroup(self):
        self._queue.append(([], []))

    @active
    def endgroup(self):
        q = self._queue.pop()
        self.entries.extend(q[0])
        self._backupentries.extend(q[1])

        offsets = []

23250:8919dc7f2dbb

        if self.journal:
            self._abort()

    @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])

        offsets = []