comparison mercurial/localrepo.py @ 27071:dfb31eebd949

localrepo: improve docstring for revset methods

revs() doesn't return a list. Also document what its arguments do.

Also clarify that set() is just a convenience wrapper around revs().

27070:7860366b46c9

    def __iter__(self):
        return iter(self.changelog)

    def revs(self, expr, *args):
        '''Return a list of revisions matching the given revset'''
        expr = revset.formatspec(expr, *args)
        m = revset.match(None, expr)
        return m(self)

    def set(self, expr, *args):
        '''
        Yield a context for each matching revision, after doing arg
        replacement via revset.formatspec
        '''
        for r in self.revs(expr, *args):
            yield self[r]

    def url(self):

27071:dfb31eebd949

    def __iter__(self):
        return iter(self.changelog)

    def revs(self, expr, *args):
        '''Find revisions matching a revset.

        The revset is specified as a string ``expr`` that may contain
        %-formatting to escape certain types. See ``revset.formatspec``.

        Return a revset.abstractsmartset, which is a list-like interface
        that contains integer revisions.
        '''
        expr = revset.formatspec(expr, *args)
        m = revset.match(None, expr)
        return m(self)

    def set(self, expr, *args):
        '''Find revisions matching a revset and emit changectx instances.

        This is a convenience wrapper around ``revs()`` that iterates the
        result and is a generator of changectx instances.
        '''
        for r in self.revs(expr, *args):
            yield self[r]

    def url(self):