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

[PATCH] cherry-pick: document rev-list options

From
Emily Shaffer via GitGitGadget <gitgitgadget@gmail.com>
Date
Aug 27, 2025, 07:17 UTC
Message-ID
<pull.2042.git.git.1756279041881.gitgitgadget@gmail.com>
From: Emily Shaffer <emilyshaffer@google.com>

In f873a273d1 (revert: accept arbitrary rev-list options, 2010-06-14), we added a handful of new options to `git cherry-pick`, but did not document them except by example. We have a nice shorthand for adding the rev-list documentation, so let's add it now.

Reported-by: Andrew Jeffrey <andrew@aj.id.au>
Signed-off-by: Emily Shaffer <emilyshaffer@google.com>
---
    cherry-pick: document rev-list options
    
    Reported on socials (https://social.tchncs.de/@arj/115099134305875190).
    rev-list-options.adoc is unfortunately pretty verbose, but I think it's
    still better than having undocumented secret options. Or, worse, options
    that are in examples but not anywhere else ;)
Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-git-2042%2Fnasamuffin%2Fcherry-pick-docs-v1
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-git-2042/nasamuffin/cherry-pick-docs-v1
Pull-Request: https://github.com/git/git/pull/2042
 Documentation/git-cherry-pick.adoc | 2 ++
 1 file changed, 2 insertions(+)
diff --git a/Documentation/git-cherry-pick.adoc b/Documentation/git-cherry-pick.adoc
index 42b41923d5f..03848aa9f21 100644
--- a/Documentation/git-cherry-pick.adoc
+++ b/Documentation/git-cherry-pick.adoc
@@ -174,6 +174,8 @@ fail unless one of `--empty=keep` or `--allow-empty` are specified.
 
 include::rerere-options.adoc[]
 
+include::rev-list-options.adoc[]
+
 SEQUENCER SUBCOMMANDS
 ---------------------
 include::sequencer.adoc[]

base-commit: f814da676ae46aac5be0a98b99373a76dee6cedb
-- 
gitgitgadget
Next: Emily Shaffer via GitGitGadget
Message 1 of 6 in “cherry-pick: document rev-list options”
  1. cherry-pick: document rev-list optionsEmily Shaffer via GitGitGadget, Aug 27, 2025
  2. doc: document rev-list opts in revert, cherry-pickEmily Shaffer via GitGitGadget, Aug 27, 2025
  3. Andrew JefferyAug 27, 2025
  4. Phillip WoodAug 27, 2025
  5. Emily ShafferAug 27, 2025
  6. Junio C HamanoAug 27, 2025

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.