[PATCH 4/5] doc: drop usage mentions of "git stash save"
- From
D. Ben Knoble <ben.knoble@gmail.com>
- Date
- Oct 12, 2026, 17:48 UTC
- Message-ID
- <5a2ea087bf35a15760206e2c8ea1f8df5a43296a.1791827304.git.ben.knoble@gmail.com>
- In-Reply-To
- <cover.1791827304.git.ben.knoble@gmail.com>
Even though we previously deprecated it in fd2ebf14db (stash: mark "git stash save" deprecated in the man page, 2017-10-22), the save subcommand clings to life. For example, 951ec747d4 (doc txt & -h consistency: make "stash" consistent, 2022-10-13) brought back "save" to the git-stash(1) synopsis, and 41a28eb6c1 (stash: implement '--staged' option for 'push' and 'save', 2021-10-18) gave it new options. But we really discourage its use in modern Git, so let's drop mention of it from -h usage and the synopsis.
It's still described in the manual, since some descriptions talk about the "save" command. As we haven't gone ahead with a full deprecation and removal, we can leave these pieces for folks whose fingers still type "save" and need a reference for its behavior.
Signed-off-by: D. Ben Knoble <ben.knoble@gmail.com> ---
Notes (benknoble/commits):
AFAICT there was no discussion of its deprecation when re-adding save to
the documentation, so I wonder if that was just an oversight.Documentation/git-stash.adoc | 2 -- builtin/stash.c | 1 - 2 files changed, 3 deletions(-)
diff --git a/Documentation/git-stash.adoc b/Documentation/git-stash.adoc index d6e8c4144c..6bf510702b 100644 --- a/Documentation/git-stash.adoc +++ b/Documentation/git-stash.adoc @@ -18,8 +18,6 @@ git stash [push] [-p | --patch] [-S | --staged] [-k | --[no-]keep-index] [-q | - [-u | --include-untracked] [-a | --all] [(-m | --message) <message>] [--pathspec-from-file=<file> [--pathspec-file-nul]] [--] [<pathspec>...] -git stash save [-p | --patch] [-S | --staged] [-k | --[no-]keep-index] [-q | --quiet] - [-u | --include-untracked] [-a | --all] [<message>] git stash clear git stash create [<message>] git stash store [(-m | --message) <message>] [-q | --quiet] <commit> diff --git a/builtin/stash.c b/builtin/stash.c index 7a9843413b..94869c2429 100644 --- a/builtin/stash.c +++ b/builtin/stash.c @@ -75,7 +75,6 @@ static const char * const git_stash_usage[] = { BUILTIN_STASH_APPLY_USAGE, BUILTIN_STASH_BRANCH_USAGE, BUILTIN_STASH_PUSH_USAGE, - BUILTIN_STASH_SAVE_USAGE, BUILTIN_STASH_CLEAR_USAGE, BUILTIN_STASH_CREATE_USAGE, BUILTIN_STASH_STORE_USAGE,
-- 2.56.0.184.g5a00b4a6e9.dirty