git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
From: Todd Zullinger <tmz@pobox.com>
To: git@vger.kernel.org
Cc: Junio C Hamano <gitster@pobox.com>,
	Johannes Schindelin <johannes.schindelin@gmx.de>
Subject: [PATCH] doc: builtin add -i is enabled by feature.experimental
Date: Tue, 15 Jun 2021 12:45:22 -0400	[thread overview]
Message-ID: <20210615164522.1079951-1-tmz@pobox.com> (raw)

Note that add.interactive.useBuiltin is enabled by feature.experimental.
It was added in 2df2d81ddd (add -i: use the built-in version when
feature.experimental is set, 2020-09-08).

Signed-off-by: Todd Zullinger <tmz@pobox.com>
---
I was checking my configuration to see if I still needed to have
add.interactive.useBuiltin set and noticed that it wasn't listed in the
settings enabled by feature.experimental.

Unless it's time to take this out of the experimental phase, it seems worth
documenting -- if for no other reason than to keep fetch.negotiationAlgorithm
from being lonely in the feature.experimental section. ;)

FWIW, I've had this enabled for perhaps a year or so and I don't recall any
instances where it hasn't worked well.  It has come in handy on some systems
where I can't easily install Perl but don't want to give up `add -[ip]`.
Thanks Dscho!

 Documentation/config/add.txt     | 3 ++-
 Documentation/config/feature.txt | 6 ++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/Documentation/config/add.txt b/Documentation/config/add.txt
index c9f748f81c..7d6d325571 100644
--- a/Documentation/config/add.txt
+++ b/Documentation/config/add.txt
@@ -9,4 +9,5 @@ add.ignore-errors (deprecated)::
 add.interactive.useBuiltin::
 	[EXPERIMENTAL] Set to `true` to use the experimental built-in
 	implementation of the interactive version of linkgit:git-add[1]
-	instead of the Perl script version. Is `false` by default.
+	instead of the Perl script version.  If `feature.experimental` is
+	enabled, this setting is `true`.  By default, it is `false`.
diff --git a/Documentation/config/feature.txt b/Documentation/config/feature.txt
index cdecd04e5b..caaa97dc61 100644
--- a/Documentation/config/feature.txt
+++ b/Documentation/config/feature.txt
@@ -12,6 +12,10 @@ feature.experimental::
 	setting if you are interested in providing feedback on experimental
 	features. The new default values are:
 +
+* `add.interactive.useBuiltin=true` which enables the built-in implementation
+of the interactive version of linkgit:git-add[1] instead of the Perl script
+version.
++
 * `fetch.negotiationAlgorithm=skipping` may improve fetch negotiation times by
 skipping more commits at a time, reducing the number of round trips.
 
 feature.manyFiles::
 	Enable config options that optimize for repos with many files in the
-- 
2.32.0


             reply	other threads:[~2021-06-15 16:45 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-06-15 16:45 Todd Zullinger [this message]
2021-06-15 19:24 ` [PATCH] doc: builtin add -i is enabled by feature.experimental Ævar Arnfjörð Bjarmason
2021-06-16  2:20 ` Junio C Hamano
2021-06-16 17:38   ` Derrick Stolee
2021-06-17 12:01 ` Johannes Schindelin

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: http://vger.kernel.org/majordomo-info.html

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20210615164522.1079951-1-tmz@pobox.com \
    --to=tmz@pobox.com \
    --cc=git@vger.kernel.org \
    --cc=gitster@pobox.com \
    --cc=johannes.schindelin@gmx.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).