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

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

From
Jon Seymour <jon.seymour@gmail.com>
Date
Sep 25, 2010, 16:18 UTC
Message-ID
<1285431515-21321-4-git-send-email-jon.seymour@gmail.com>
In-Reply-To
<1285431515-21321-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.4.g73371.dirty
Previous: Jon SeymourNext: Jon Seymour
Message 4 of 7 in “rev-parse: allow --flags to output rev-parse-like flags”
  1. 0/4 rev-parse: allow --flags to output rev-parse-like flagsJon Seymour, Sep 25, 2010
  2. 1/4 rev-parse: stop interpreting flags as options to rev-parse once --flags is specifiedJon Seymour, Sep 25, 2010
  3. 2/4 rev-parse: add tests for git rev-parse --flags.Jon Seymour, Sep 25, 2010
  4. 3/4 rev-parse: update documentation of --flags and --no-flags optionsJon Seymour, Sep 25, 2010
  5. 4/4 rev-parse: make --flags imply --no-revs for remaining arguments.Jon Seymour, Sep 25, 2010
  6. Jon SeymourSep 25, 2010
  7. 0/4 rev-parse: allow --flags to output rev-parse-like flagsJon Seymour, Sep 26, 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.