• J
    rev-list: "adjust" results of "--count --use-bitmap-index -n" · 5c9f9bf3
    Jeff King 提交于
    If you ask rev-list for:
    
        git rev-list --count --use-bitmap-index HEAD
    
    we optimize out the actual traversal and just give you the
    number of bits set in the commit bitmap. This is faster,
    which is good.
    
    But if you ask to limit the size of the traversal, like:
    
        git rev-list --count --use-bitmap-index -n 100 HEAD
    
    we'll still output the full bitmapped number we found. On
    the surface, that might even seem OK. You explicitly asked
    to use the bitmap index, and it was cheap to compute the
    real answer, so we gave it to you.
    
    But there's something much more complicated going on under
    the hood. If we don't have a bitmap directly for HEAD, then
    we have to actually traverse backwards, looking for a
    bitmapped commit. And _that_ traversal is bounded by our
    `-n` count.
    
    This is a good thing, because it bounds the work we have to
    do, which is probably what the user wanted by asking for
    `-n`. But now it makes the output quite confusing. You might
    get many values:
    
      - your `-n` value, if we walked back and never found a
        bitmap (or fewer if there weren't that many commits)
    
      - the actual full count, if we found a bitmap root for
        every path of our traversal with in the `-n` limit
    
      - any number in between! We might have walked back and
        found _some_ bitmaps, but then cut off the traversal
        early with some commits not accounted for in the result.
    
    So you cannot even see a value higher than your `-n` and say
    "OK, bitmaps kicked in, this must be the real full count".
    The only sane thing is for git to just clamp the value to a
    maximum of the `-n` value, which means we should output the
    exact same results whether bitmaps are in use or not.
    
    The test in t5310 demonstrates this by using `-n 1`.
    Without this patch we fail in the full-bitmap case (where we
    do not have to traverse at all) but _not_ in the
    partial-bitmap case (where we have to walk down to find an
    actual bitmap). With this patch, both cases just work.
    
    I didn't implement the crazy in-between case, just because
    it's complicated to set up, and is really a subset of the
    full-count case, which we do cover.
    Signed-off-by: NJeff King <peff@peff.net>
    Signed-off-by: NJunio C Hamano <gitster@pobox.com>
    5c9f9bf3
rev-list.c 10.1 KB