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

From: "Emily Shaffer via GitGitGadget" <[email-masked]>
Date: Wed, 27 Aug 2025 07:17:21 +0000

From: Emily Shaffer <[email-masked]>

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 <[email-masked]>
Signed-off-by: Emily Shaffer <[email-masked]>
---
    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