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

[PATCH 5/7] git-log.txt: rewrite note on why "--" may be required

From
Ramkumar Ramachandra <artagnon@gmail.com>
Date
Apr 22, 2013, 05:30 UTC
Message-ID
<1366608631-21734-6-git-send-email-artagnon@gmail.com>
In-Reply-To
<1366608631-21734-1-git-send-email-artagnon@gmail.com>

In its current form, the note talks about separating options from "branch names" and "refnames" in the same sentence. This is entirely inaccurate, as <revision range> need not be a set of branch names or ref names. Rewrite it to use the word "revision range", to be consistent with the SYNOPSIS.

Signed-off-by: Ramkumar Ramachandra <artagnon@gmail.com>
---
 Documentation/git-log.txt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/Documentation/git-log.txt b/Documentation/git-log.txt
index 9576695..a976534 100644
--- a/Documentation/git-log.txt
+++ b/Documentation/git-log.txt
@@ -77,8 +77,8 @@ produced by --stat etc.
 	Simplification" below for details and other simplification
 	modes.
 +
-To prevent confusion with options and branch names, paths may need to
-be prefixed with "\-- " to separate them from options or refnames.
+Paths may need to be prefixed with "\-- " to separate them from
+options or the revision range, when confusion arises.
 
 include::rev-list-options.txt[]
 
-- 
1.8.2.1.501.gd2949c7
Previous: Ramkumar RamachandraNext: Junio C Hamano
Message 6 of 13 in “Documentation/shortlog improvements”
  1. 0/7 Documentation/shortlog improvementsRamkumar Ramachandra, Apr 22, 2013
  2. 1/7 git-shortlog.txt: remove (-h|--help) from OPTIONSRamkumar Ramachandra, Apr 22, 2013
  3. 2/7 revisions.txt: clarify the .. and ... syntaxRamkumar Ramachandra, Apr 22, 2013
  4. 3/7 git-log.txt: order OPTIONS properly; move <since>..<until>Ramkumar Ramachandra, Apr 22, 2013
  5. 4/7 git-log.txt: generalize <since>..<until>Ramkumar Ramachandra, Apr 22, 2013
  6. 5/7 git-log.txt: rewrite note on why "--" may be requiredRamkumar Ramachandra, Apr 22, 2013
  7. Re* [PATCH 5/7] git-log.txt: rewrite note on why "--" may be requiredJunio C Hamano, Apr 25, 2013
  8. Ramkumar RamachandraApr 25, 2013
  9. Junio C HamanoApr 29, 2013
  10. Ramkumar RamachandraApr 29, 2013
  11. 6/7 git-shortlog.txt: make SYNOPSIS match log, update OPTIONSRamkumar Ramachandra, Apr 22, 2013
  12. 7/7 builtin/shortlog.c: make usage string consistent with logRamkumar Ramachandra, Apr 22, 2013
  13. 5/7 builtin/log.c: make usage string consistent with docRamkumar Ramachandra, Apr 22, 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.