git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] completion: verify-tag is not plumbing

From
Junio C Hamano <gitster@pobox.com>
Date
Feb 1, 2016, 18:51 UTC
Message-ID
<xmqq8u34w9fc.fsf@gitster.mtv.corp.google.com>
In-Reply-To
<20160201104411.GD29880@serenity.lan>
John Keeping <john@keeping.me.uk> writes:
> I can accept that argument about verify-commit and verify-tag, but
> listing verify-tag as plumbing is incorrect according to
> command-list.txt (and thus git(1)).  If we're going to classify
> commands, shouldn't we be consistent in how we do so?

These are not meant to be "classifications", but "justifications". When somebody asks "why isn't this command tab-completed?", you can find the explanation e.g. "because it is rarely used".

A command being 'plumbing' does not have to make it automatically ineligible from getting tab-completed. For some small tasks, running a plumbing command may be the easiest way to achieve them in the interactive session, and it helps to have tab-completion for such a plumbing command (e.g. "git apply" is completed, IIRC).

Also often the line between plumbing and Porcelain is somewhat blurry. I'd consider ancillaryX categories in command-list.txt a cop-out myself.

In this particular case, saying "better use 'tag --verify'" there instead of "plumbing" may be more helpful for those who are reading this script.

Show 20 quoted lines
>> > Signed-off-by: John Keeping <john@keeping.me.uk>
>> > ---
>> >  contrib/completion/git-completion.bash | 1 -
>> >  1 file changed, 1 deletion(-)
>> >
>> > diff --git a/contrib/completion/git-completion.bash
>> > b/contrib/completion/git-completion.bash
>> > index 51f5223..250788a 100644
>> > --- a/contrib/completion/git-completion.bash
>> > +++ b/contrib/completion/git-completion.bash
>> > @@ -728,7 +728,6 @@ __git_list_porcelain_commands ()
>> >  		write-tree)       : plumbing;;
>> >  		var)              : infrequent;;
>> >  		verify-pack)      : infrequent;;
>> > -		verify-tag)       : plumbing;;
>> >  		*) echo $i;;
>> >  		esac
>> >  	done
>> > --
>> > 2.7.0
Previous: John Keeping
Message 4 of 4 in “completion: verify-tag is not plumbing”
  1. completion: verify-tag is not plumbingJohn Keeping, Jan 31, 2016
  2. SZEDER GáborJan 31, 2016
  3. John KeepingFeb 1, 2016
  4. Junio C HamanoFeb 1, 2016

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.