OSDN Git Service

diff_unique_abbrev(): document its assumption and limitation
authorJunio C Hamano <gitster@pobox.com>
Fri, 30 Sep 2016 17:42:05 +0000 (10:42 -0700)
committerJunio C Hamano <gitster@pobox.com>
Sat, 1 Oct 2016 01:06:50 +0000 (18:06 -0700)
commitd709f1fb9d3bfa148dd8b461e633138fdf5957e6
tree2c96364852f21c3ed557e8ca6429748bd5cf0b21
parent92d426662b0673adcd41995e6c2f0afcb9ad39af
diff_unique_abbrev(): document its assumption and limitation

This function is used to add "..." to displayed object names in
"diff --raw --abbrev[=<n>]" output.  It bases its behaviour on an
untold assumption that the abbreviation length requested by the
caller is "reasonble", i.e. most of the objects will abbreviate
within the requested length and the resulting length would never
exceed it by more than a few hexdigits (otherwise the resulting
columns would not align).  Explain that in a comment.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
diff.c