From: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Date: Sat, 29 May 2021 14:27:54 +0000 (-0700)
Subject: Add --experimental-string-processing to future changes (#2273)
X-Git-Url: https://git.madduck.net/etc/vim.git/commitdiff_plain/33e2b4401439f2015065704c08d22f008f016235?ds=sidebyside

Add --experimental-string-processing to future changes (#2273)

* add esp to future style

* changelog

* fix label
---

diff --git a/CHANGES.md b/CHANGES.md
index 5f570e2..0d595bb 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -23,6 +23,7 @@
 
 ### Documentation
 
+- `--experimental-string-processing` will be enabled by default in the future (#2273)
 - Fix typos discovered by codespell (#2228)
 - Fix Vim plugin installation instructions. (#2235)
 - Add new Frequently Asked Questions page (#2247)
diff --git a/docs/the_black_code_style/current_style.md b/docs/the_black_code_style/current_style.md
index 00001db..8c3a302 100644
--- a/docs/the_black_code_style/current_style.md
+++ b/docs/the_black_code_style/current_style.md
@@ -250,6 +250,8 @@ If you are adopting _Black_ in a large project with pre-existing string conventi
 you can pass `--skip-string-normalization` on the command line. This is meant as an
 adoption helper, avoid using this for new projects.
 
+(labels/experimental-string)=
+
 As an experimental option (can be enabled by `--experimental-string-processing`),
 _Black_ splits long strings (using parentheses where appropriate) and merges short ones.
 When split, parts of f-strings that don't need formatting are converted to plain
diff --git a/docs/the_black_code_style/future_style.md b/docs/the_black_code_style/future_style.md
index aca9fe0..a767609 100644
--- a/docs/the_black_code_style/future_style.md
+++ b/docs/the_black_code_style/future_style.md
@@ -33,3 +33,10 @@ with \
 
 Although when the target version is Python 3.9 or higher, _Black_ will use parentheses
 instead since they're allowed in Python 3.9 and higher.
+
+## Improved string processing
+
+Currently, _Black_ does not split long strings to fit the line length limit. Currently,
+there is [an experimental option](labels/experimental-string) to enable splitting
+strings. We plan to enable this option by default once it is fully stable. This is
+tracked in [this issue](https://github.com/psf/black/issues/2188).