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

[PATCH 3/7] revisions.txt: clarify the .. and ... syntax

From
Ramkumar Ramachandra <artagnon@gmail.com>
Date
Apr 21, 2013, 08:50 UTC
Message-ID
<1366534252-12099-4-git-send-email-artagnon@gmail.com>
In-Reply-To
<1366534252-12099-1-git-send-email-artagnon@gmail.com>

In <rev1>..<rev2> and <rev1>...<rev2>, if either <rev1> or <rev2> is omitted, it defaults to 'HEAD'. Add this detail to the document.

Signed-off-by: Ramkumar Ramachandra <artagnon@gmail.com>
---
 Documentation/revisions.txt | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/Documentation/revisions.txt b/Documentation/revisions.txt
index 8855b1a..0a23129 100644
--- a/Documentation/revisions.txt
+++ b/Documentation/revisions.txt
@@ -244,11 +244,13 @@ To summarize:
 
 '<rev1>..<rev2>'::
 	Include commits that are reachable from <rev2> but exclude
-	those that are reachable from <rev1>.
+	those that are reachable from <rev1>.  When either <rev1> or
+	<rev2> is omitted, it defaults to 'HEAD'.
 
 '<rev1>\...<rev2>'::
 	Include commits that are reachable from either <rev1> or
-	<rev2> but exclude those that are reachable from both.
+	<rev2> but exclude those that are reachable from both.  When
+	either <rev1> or <rev2> is omitted, it defaults to 'HEAD'.
 
 '<rev>{caret}@', e.g. 'HEAD{caret}@'::
   A suffix '{caret}' followed by an at sign is the same as listing
-- 
1.8.2.1.501.gd2949c7
Previous: Ramkumar RamachandraNext: Ramkumar Ramachandra
Message 4 of 10 in “Documentation/shortlog improvements”
  1. 0/7 Documentation/shortlog improvementsRamkumar Ramachandra, Apr 21, 2013
  2. 1/7 git-shortlog.txt: remove (-h|--help) from OPTIONSRamkumar Ramachandra, Apr 21, 2013
  3. 2/7 builtin/shortlog.c: make usage string consistent with logRamkumar Ramachandra, Apr 21, 2013
  4. 3/7 revisions.txt: clarify the .. and ... syntaxRamkumar Ramachandra, Apr 21, 2013
  5. 4/7 git-log.txt: order OPTIONS properly; move <since>..<until>Ramkumar Ramachandra, Apr 21, 2013
  6. 5/7 git-log.txt: generalize <since>..<until>Ramkumar Ramachandra, Apr 21, 2013
  7. Junio C HamanoApr 21, 2013
  8. 6/7 git-log.txt: rewrite note on why "--" may be requiredRamkumar Ramachandra, Apr 21, 2013
  9. 7/7 git-shortlog.txt: make SYNOPSIS match log, update OPTIONSRamkumar Ramachandra, Apr 21, 2013
  10. Junio C HamanoApr 21, 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.