Re: [PATCH v2 4/4] branch: make "-l" a synonym for "--list"
- From
Jeff King <peff@peff.net>
- Date
- Aug 30, 2018, 20:50 UTC
- Message-ID
- <20180830205033.GA27399@sigill.intra.peff.net>
- In-Reply-To
- <xmqqo9dj4mym.fsf@gitster-ct.c.googlers.com>
On Thu, Aug 30, 2018 at 01:29:53PM -0700, Junio C Hamano wrote:
Show 16 quoted lines
> >> > I do not know if the documentation that is shipped in 2.20 should
> >> > talk about how the old world looked like, though. `-l` was a short
> >> > for `--create-reflog` is worth saying, but I do not see much value
> >> > in talking about the warning given in 2.19.
> >>
> >> I'm anticipating that there will be users in the wild with similar -l
> >> invocations, noting this helps them, because they'll be wondering what
> >> some script that does "git branch -l <name>" is trying to do while
> >> reading our docs.
> >
> > I don't have a strong opinion either way. If we do mention it, it should
> > probably be short ("Until Git v2.20, the `-l` option was a synonym for
> > `--create-reflog").
>
> I agree that the short one would of course be good. I am on the
> fence about mentioning the warning only given in 2.19.Yeah, I was confused about that part of the thread. Is there something proposed to (additionally) go into v2.19? Ævar, can you elaborate?
-Peff