From: D. Ben Knoble Date: Mon, 12 Oct 2026 17:48:30 GMT Subject: [PATCH 4/5] doc: drop usage mentions of "git stash save" Message-ID: <5a2ea087bf35a15760206e2c8ea1f8df5a43296a.1791827304.git.ben.knoble@gmail.com> In-Reply-To: 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 --- 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) ] [--pathspec-from-file= [--pathspec-file-nul]] [--] [...] -git stash save [-p | --patch] [-S | --staged] [-k | --[no-]keep-index] [-q | --quiet] - [-u | --include-untracked] [-a | --all] [] git stash clear git stash create [] git stash store [(-m | --message) ] [-q | --quiet] 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