completion: add proper public __git_complete
authorFelipe Contreras <felipe.contreras@gmail.com>
Wed, 30 Dec 2020 23:29:50 +0000 (17:29 -0600)
committerJunio C Hamano <gitster@pobox.com>
Mon, 4 Jan 2021 23:25:56 +0000 (15:25 -0800)
commit5a067ba9d04eebc92ad77f101b785219238f4f1e
tree5c8dd921b4344c06c65e824d180dc98186938880
parent0e02bdc17a4d4beca06d5606a1d3020c79676d7f
completion: add proper public __git_complete

When __git_complete was introduced, it was meant to be temporarily, while
a proper guideline for public shell functions was established
(tentatively _GIT_complete), but since that never happened, people
in the wild started to use __git_complete, even though it was marked as
not public.

Eight years is more than enough wait, let's mark this function as
public, and make it a bit more user-friendly.

So that instead of doing:

  __git_complete gk __gitk_main

The user can do:

  __git_complete gk gitk

And instead of:

  __git_complete gf _git_fetch

Do:

  __git_complete gf git_fetch

Backwards compatibility is maintained.

Signed-off-by: Felipe Contreras <felipe.contreras@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
contrib/completion/git-completion.bash
t/t9902-completion.sh