comparison mercurial/changegroup.py @ 27219:beb60a898dd0

changegroup: document manifest linkrev callback some more

Martin and I just got super-confused reading some code here, so I
think it's time for some more documentation.

27218:de3335b4c8ef

        fastpathlinkrev = fastpathlinkrev and not self._reorder
        # Callback for the manifest, used to collect linkrevs for filelog
        # revisions.
        # Returns the linkrev node (collected in lookupcl).
        def lookupmflinknode(x):
            clnode = mfs[x]
            if not fastpathlinkrev:
                mdata = ml.readfast(x)
                for f, n in mdata.iteritems():
                    if f in changedfiles:

27219:beb60a898dd0

        fastpathlinkrev = fastpathlinkrev and not self._reorder
        # Callback for the manifest, used to collect linkrevs for filelog
        # revisions.
        # Returns the linkrev node (collected in lookupcl).
        def lookupmflinknode(x):
            """Callback for looking up the linknode for manifests.

            Returns the linkrev node for the specified manifest.

            SIDE EFFECT:

              fclnodes gets populated with the list of relevant
              file nodes if we're not using fastpathlinkrev.

            Note that this means you can't trust fclnodes until
            after manifests have been sent to the client.
            """
            clnode = mfs[x]
            if not fastpathlinkrev:
                mdata = ml.readfast(x)
                for f, n in mdata.iteritems():
                    if f in changedfiles: