From: Yilei "Dolee" Yang Date: Sat, 14 Jan 2023 17:51:59 +0000 (-0800) Subject: Documentation: clarify the state of multiple context managers (#3488) X-Git-Url: https://git.madduck.net/etc/vim.git/commitdiff_plain/f7580103407743a317e22297793822dd91f8fefe Documentation: clarify the state of multiple context managers (#3488) Clarify that the backslash & paren-wrapping formatting for multiple context managers aren't yet implemented. --- diff --git a/docs/the_black_code_style/future_style.md b/docs/the_black_code_style/future_style.md index 17b7eef..9ca260f 100644 --- a/docs/the_black_code_style/future_style.md +++ b/docs/the_black_code_style/future_style.md @@ -19,7 +19,7 @@ with make_context_manager1() as cm1, make_context_manager2() as cm2, make_contex ... # nothing to split on - line too long ``` -So _Black_ will eventually format it like this: +So _Black_ will, when we implement this, format it like this: ```py3 with \ @@ -31,8 +31,8 @@ with \ ... # backslashes and an ugly stranded colon ``` -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. +Although when the target version is Python 3.9 or higher, _Black_ will, when we +implement this, use parentheses instead since they're allowed in Python 3.9 and higher. An alternative to consider if the backslashes in the above formatting are undesirable is to use {external:py:obj}`contextlib.ExitStack` to combine context managers in the