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

Re: [PATCH] git-bisect.txt: clarify that reset finishes bisect

From
AMAndreas Mohr <andi@lisas.de>
Date
Feb 10, 2013, 00:23 UTC
Message-ID
<20130210002305.GB5744@rhlx01.hs-esslingen.de>
In-Reply-To
<7vy5ext60o.fsf@alter.siamese.dyndns.org>
On Sat, Feb 09, 2013 at 03:35:35PM -0800, Junio C Hamano wrote:
Show 10 quoted lines
> Andreas Mohr <andi@lisas.de> writes:
> > The main point of my mail was to stretch the (whether actually intended)
> > *perceived* start <-> stop symmetry
> 
> Actually, in that sense, I do no think finish is exactly a good
> wording.  The majority of use case would be to finish up after you
> found the sole culprit, so in that sense "finish" is not too bad,
> but in general, when you "reset", there is not necessarily any
> symmmetry with "start".  We should definitely not be giving you an
> illusion that there is one by using "stop" [*1*].

Yeah, of course, but the whole point was that the *user* will *directly* and *immediately* mentally go from a bisect "start" parameter to "stop", and end up failing to find it. Thus the "stop" *KEYWORD* *has* to be mentioned in the man page (even if only to then expressly state that reset is not quite about "stop"iing things).

> *1* another reason to avoid "stop" is that it could mean "I stop
> here for now, to later come back and start digging again from
> there", which is not "reset" is about at all.

Such reasons for not listing "stop" might even be stronger than the reason of users being required to successfully look up the symmetric "stop" keyword. If that was decided to be the case, then "stop" would indeed have to be omitted in the man page - to the detriments of usability.

Thanks,
Andreas Mohr
Previous: Junio C HamanoNext: Jonathan Nieder
Message 5 of 9 in “git-bisect.txt: clarify that reset finishes bisect”
  1. git-bisect.txt: clarify that reset finishes bisectMichael J Gruber, Feb 9, 2013
  2. Junio C HamanoFeb 9, 2013
  3. Andreas MohrFeb 9, 2013
  4. Junio C HamanoFeb 9, 2013
  5. Andreas MohrFeb 10, 2013
  6. Jonathan NiederFeb 10, 2013
  7. Michael J GruberFeb 11, 2013
  8. [PATCHv2] git-bisect.txt: clarify that reset quits bisectMichael J Gruber, Feb 11, 2013
  9. Jonathan NiederFeb 11, 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.