@matheusbsbs / matheus-bagliano / commits / a0d2ceb276
Fork 0

doc/rev-parse: clarify reflog vs --until for specifying revisions

The rev-parse manpage introduces the branch@{date} syntax, and mentions the reflog specifically. However, new users may not be familiar with the distinction between the reflog and the commit date, so let's help them out with a "you may be interested in --until" pointer. Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>

Jeff King committed Jun 29, 2008 at 23:27 UTC a0d2ceb2769731571cdd195582bfedf90225e712
1 file changed +4 -1
Documentation/git-rev-parse.txt
+4 -1
@@ -184,7 +184,10 @@ blobs contained in a commit.
184 second ago\}' or '\{1979-02-26 18:30:00\}') to specify the value
185 of the ref at a prior point in time. This suffix may only be
186 used immediately following a ref name and the ref must have an
187 - existing log ($GIT_DIR/logs/<ref>).
187 + existing log ($GIT_DIR/logs/<ref>). Note that this looks up the state
188 + of your *local* ref at a given time; e.g., what was in your local
189 + `master` branch last week. If you want to look at commits made during
190 + certain times, see `--since` and `--until`.
191
192 * A ref followed by the suffix '@' with an ordinal specification
193 enclosed in a brace pair (e.g. '\{1\}', '\{15\}') to specify