From: Todd Zullinger <tmz@pobox.com>
To: Jonathan Nieder <jrnieder@gmail.com>
Cc: "François WAUQUIER" <wokier@gmail.com>,
"Nguyễn Thái Ngọc Duy" <pclouds@gmail.com>,
git@vger.kernel.org
Subject: Re: git checkout -
Date: Sat, 4 Jan 2020 00:17:41 -0500 [thread overview]
Message-ID: <20200104051741.GJ9927@pobox.com> (raw)
In-Reply-To: <20200104004826.GC130883@google.com>
Hi,
Jonathan Nieder wrote:
> Hi,
>
> François WAUQUIER wrote:
>
>> $ git checkout -
>>
>> I often use this command to go back to previous branch from my history.
>> It is quite natural as it uses the same syntax as “cd -“
>>
>> But i found out it is not documented in
>> https://git-scm.com/docs/git-checkout/2.24.0
>> I report this to help others to discover this time saving command.
>
> Thanks for reporting!
>
> Ideas for what the documentation should say about it? (Bonus points
> if it comes in the form of a patch against Documentation/git-checkout.txt.
> ;-) See [1] for more about how that works.)
Not to say that it can't possibly be improved, but it is
mentioned in the git-checkout docs here[1]. The second
paragraph in that section says:
You can use the @{-N} syntax to refer to the N-th last
branch/commit checked out using "git checkout"
operation. You may also specify - which is synonymous to
@{-1}.
This is also in the git-switch documentation, where it might
be easier to find, as it's very close to the beginning of
git-switch's man page, in the "<start-point>" entry of the
OPTIONS section[2].
Being easy to miss in the git-checkout documentation might
make Duy smile; it shows the benefit of splitting some of
the many features of 'checkout' to the 'switch' command. :)
[1] https://git-scm.com/docs/git-checkout#Documentation/git-checkout.txt-ltbranchgt
[2] https://git-scm.com/docs/git-switch#Documentation/git-switch.txt-ltstart-pointgt
--
Todd
prev parent reply other threads:[~2020-01-04 5:18 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-01-03 12:40 François WAUQUIER
2020-01-04 0:48 ` git checkout - Jonathan Nieder
2020-01-04 5:17 ` Todd Zullinger [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: http://vger.kernel.org/majordomo-info.html
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20200104051741.GJ9927@pobox.com \
--to=tmz@pobox.com \
--cc=git@vger.kernel.org \
--cc=jrnieder@gmail.com \
--cc=pclouds@gmail.com \
--cc=wokier@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).