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

Re: [RFC PATCH] Revamp git-cherry(1)

From
Junio C Hamano <gitster@pobox.com>
Date
Nov 21, 2013, 22:04 UTC
Message-ID
<xmqqwqk12yyz.fsf@gitster.dls.corp.google.com>
In-Reply-To
<87pppt31v9.fsf@thomasrast.ch>
Thomas Rast <tr@thomasrast.ch> writes:
Show 15 quoted lines
> Junio C Hamano <gitster@pobox.com> writes:
>
>>>  OPTIONS
>>>  -------
>>>  -v::
>>> -	Verbose.
>>> +	Verbose.  Currently shows the commit subjects next to their
>>> +	SHA1.
>>
>> Whenever I see "Currently", it makes me wonder "why does it need to
>> say that? Is there a plan to change it soon, and if so where is the
>> plan described?".
>
> I wanted to avoid documenting exactly what it does, so that in the
> future it could do more than that.  Is that overly paranoid?

I would have to say so. After all, the documentation is supposed to describe the current state of affairs, and we would update it when "the current state" changes. In places, we may express our plan to forewarn readers of planned upcoming changes, but still...

Previous: Thomas RastNext: Thomas Rast
Message 6 of 10 in “Revamp git-cherry(1)”
  1. Revamp git-cherry(1)Thomas Rast, Nov 21, 2013
  2. Jeff KingNov 21, 2013
  3. Thomas RastNov 21, 2013
  4. Junio C HamanoNov 21, 2013
  5. Thomas RastNov 21, 2013
  6. Junio C HamanoNov 21, 2013
  7. Revamp git-cherry(1)Thomas Rast, Nov 22, 2013
  8. Junio C HamanoNov 22, 2013
  9. Thomas RastNov 22, 2013
  10. Junio C HamanoNov 22, 2013

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.