Re: [PATCH v3 4/6] git.c: implement --list-cmds=porcelain

From: Duy Nguyen <pclouds@gmail.com>
Date: Apr 25, 2018, 14:39 UTC
Message-ID: <CACsJy8Chk5C8BgHsZfhYugBAAwzAUJXQLhq0EYmT2m9us6E6xA@mail.gmail.com>
In-Reply-To: <CAM0VKjmZeVF6GV9ZRXLdwZJJyFi8oLnGvKe7tQYi_QRLoAk4Og@mail.gmail.com>

On Wed, Apr 25, 2018 at 3:06 PM, SZEDER Gábor <szeder.dev@gmail.com> wrote:

Show 10 quoted lines

>> -__git_list_all_commands ()
>
>> -__git_list_porcelain_commands ()
>
> Users can have their own completion scriptlets for their own git
> commands, and these should be able to rely on helper functions in
> git-completion.bash to do things like refs completion and what not.
> Therefore, we tend not to remove or alter those helper functions in a
> backwards incompatible way, because we don't want to break those
> completion scriptlets.

What kind of "API" guarantee do we provide here? I don't mind adding the wrappers, but for me it's hard for new contributors (like me) to see which one should be stable and which one is internal.

-- 
Duy