[PATCH 1/1] stash: document stash.useBuiltin
- Date: Tue, 14 May 2019 02:19:15 -0700 (PDT)
- From: "Johannes Schindelin via GitGitGadget" <gitgitgadget@xxxxxxxxx>
- Subject: [PATCH 1/1] stash: document stash.useBuiltin
From: Johannes Schindelin <johannes.schindelin@xxxxxx>
The stash.useBuiltin variable introduced in 90a462725e ("stash:
optionally use the scripted version again", 2019-02-25) was turned on by
default, but had no documentation.
Let's document it so that users who run into any stability issues with
the C rewrite know there's an escape hatch, and spell out that the
user should please report the bug when they have to turn off the
Signed-off-by: Johannes Schindelin <johannes.schindelin@xxxxxx>
Documentation/config/stash.txt | 15 +++++++++++++++
1 file changed, 15 insertions(+)
diff --git a/Documentation/config/stash.txt b/Documentation/config/stash.txt
index c583d46d6b..d7bf6ec61f 100644
@@ -1,3 +1,18 @@
+ Set to `false` to use the legacy shell script implementation of
+ linkgit:git-stash. Is `true` by default, which means use
+ the built-in rewrite of it in C.
+The C rewrite is first included with Git version 2.22 (and Git for Windows
+version 2.19). This option serves an an escape hatch to re-enable the
+legacy version in case any bugs are found in the rewrite. This option and
+the shell script version of linkgit:git-stash will be removed in some
+If you find some reason to set this option to `false` other than
+one-off testing you should report the behavior difference as a bug in
+git (see https://git-scm.com/community for details).
If this is set to true, the `git stash show` command without an
option will show the stash entry in patch form. Defaults to false.