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

[PATCH v3 3/3] rev-parse: update documentation of --flags and --no-flags options

From
Jon Seymour <jon.seymour@gmail.com>
Date
Sep 25, 2010, 11:22 UTC
Message-ID
<1285413763-25082-4-git-send-email-jon.seymour@gmail.com>
In-Reply-To
<1285413763-25082-1-git-send-email-jon.seymour@gmail.com>
Signed-off-by: Jon Seymour <jon.seymour@gmail.com>
---
 Documentation/git-rev-parse.txt |   12 +++++++++++-
 1 files changed, 11 insertions(+), 1 deletions(-)
diff --git a/Documentation/git-rev-parse.txt b/Documentation/git-rev-parse.txt
index 341ca90..f5e6637 100644
--- a/Documentation/git-rev-parse.txt
+++ b/Documentation/git-rev-parse.txt
@@ -49,10 +49,20 @@ OPTIONS
 	'git rev-list' command.
 
 --flags::
-	Do not output non-flag parameters.
+	Do not output non-flag parameters which are not also revisions.
+	+
+	If specified, this option causes 'git rev-parse' to stop
+	interpreting remaining arguments as options for its own
+	consumption. As such, this option should be specified
+	after all other options that 'git rev-parse' is expected
+	to interpret.
 
 --no-flags::
 	Do not output flag parameters.
+	+
+	If both `--flags` and `--no-flags` are specified, the first
+	option specified wins and the other option is treated like
+	a non-option argument.
 
 --default <arg>::
 	If there is no parameter given by the user, use `<arg>`
-- 
1.7.3.2.g216ca.dirty
Previous: Jon Seymour
Message 4 of 4 in “rev-parse: allow --flags to output rev-parse-like flags”
  1. 0/3 rev-parse: allow --flags to output rev-parse-like flagsJon Seymour, Sep 25, 2010
  2. 1/3 rev-parse: stop interpreting flags as options to rev-parse once --flags is specifiedJon Seymour, Sep 25, 2010
  3. 2/3 rev-parse: add tests for git rev-parse --flags.Jon Seymour, Sep 25, 2010
  4. 3/3 rev-parse: update documentation of --flags and --no-flags optionsJon Seymour, Sep 25, 2010

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.