From: Łukasz Langa <lukasz@langa.pl>
Date: Wed, 16 May 2018 22:26:36 +0000 (-0700)
Subject: Explain automatic parentheses management better
X-Git-Url: https://git.madduck.net/etc/vim.git/commitdiff_plain/665ed8a2403161a987c49e1818f2376840723b96

Explain automatic parentheses management better
---

diff --git a/README.md b/README.md
index ed69cb8..8b7b2bd 100644
--- a/README.md
+++ b/README.md
@@ -340,7 +340,19 @@ interesting cases:
 
 In those cases, parentheses are removed when the entire statement fits
 in one line, or if the inner expression doesn't have any delimiters to
-further split on.  Otherwise, the parentheses are always added.
+further split on.  If there is only a single delimiter and the expression
+starts or ends with a bracket, the parenthesis can also be successfully
+omitted since the existing bracket pair will organize the expression
+neatly anyway.  Otherwise, the parentheses are added.
+
+Please note that *Black* does not add or remove any additional nested
+parentheses that you might want to have for clarity or further
+code organization.  For example those parentheses are not going to be
+removed:
+```py3
+return not (this or that)
+decision = (maybe.this() and values > 0) or (maybe.that() and values < 0)
+```
 
 ### Call chains