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

Re: is there a stylistic preference for a trailing "--" on a command?

From
Stefan Beller <sbeller@google.com>
Date
Nov 10, 2017, 18:12 UTC
Message-ID
<CAGZ79kavxFA_wBzcSbR8LT4uZGkdv4c07ZMfE4TK0tkooMGg6Q@mail.gmail.com>
In-Reply-To
<alpine.LFD.2.21.1711100855140.3617@DESKTOP-1GPMCEJ>
On Fri, Nov 10, 2017 at 5:57 AM, Robert P. J. Day <rpjday@crashcourse.ca> wrote:
Show 13 quoted lines
>
>   just noticed these examples in "man git-bisect":
>
> EXAMPLES
>   $ git bisect start HEAD v1.2 --      # HEAD is bad, v1.2 is good
>   ...
>   $ git bisect start HEAD origin --    # HEAD is bad, origin is good
>   ...
>   $ git bisect start HEAD HEAD~10 --   # culprit is among the last 10
>
> is there some rationale or stylistic significance to those trailing
> "--" on those commands? i assume they have no effect, just curious as
> to why they're there.

By having the -- there, it is clear that the strings are ref specs and not files of such a name. (Who would want to store a file named HEAD~10 in their repo?)

Previous: Robert P. J. DayNext: Jeff King
Message 2 of 4 in “is there a stylistic preference for a trailing "--" on a command?”
  1. Robert P. J. DayNov 10, 2017
  2. Stefan BellerNov 10, 2017
  3. Jeff KingNov 11, 2017
  4. Junio C HamanoNov 12, 2017

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.