comparison mercurial/revset.py @ 22716:6877ba8d85ff

abstractsmartset: document the `fastasc` and `fastdesc` attributes/methods

See the in-line documentation for details. (This is the beginning of a massive
overhaul of revset).

22715:557749fea14a

    def __iter__(self):
        """iterate the set in the order it is supposed to be iterated"""
        raise NotImplementedError()

    def isascending(self):
        """True if the set will iterate in ascending order"""
        raise NotImplementedError()

    def ascending(self):

22716:6877ba8d85ff

    def __iter__(self):
        """iterate the set in the order it is supposed to be iterated"""
        raise NotImplementedError()

    # Attributes containing a function to perform a fast iteration in a given
    # direction. A smartset can have none, one, or both defined.
    #
    # Default value is None instead of a function returning None to avoid
    # initializing an iterator just for testing if a fast method exists.
    fastasc = None
    fastdesc = None

    def isascending(self):
        """True if the set will iterate in ascending order"""
        raise NotImplementedError()

    def ascending(self):