Fix double colon (#216)

[etc/vim.git] / README.md

diff --git a/README.md b/README.md
index ed69cb835eafe07da148e13bdfe118514fab0690..e192826c6475fd940095b0999a21d1861eca84ed 100644 (file)
--- 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
 
 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
 
 
 ### Call chains
 


@@ -348,7 +360,7 @@ Some popular APIs, like ORMs, use call chaining.  This API style is known
 as a [fluent interface](https://en.wikipedia.org/wiki/Fluent_interface).
 *Black* formats those treating dots that follow a call or an indexing
 operation like a very low priority delimiter.  It's easier to show the
 as a [fluent interface](https://en.wikipedia.org/wiki/Fluent_interface).
 *Black* formats those treating dots that follow a call or an indexing
 operation like a very low priority delimiter.  It's easier to show the

-behavior than to explain it.  Look at the example::
+behavior than to explain it.  Look at the example:

 ```py3
 def example(session):
     result = (
 ```py3
 def example(session):
     result = (


@@ -641,6 +653,9 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md).
 * fixed non-deterministic formatting when multiple pairs of removable parentheses
   were used (#183)
 
 * fixed non-deterministic formatting when multiple pairs of removable parentheses
   were used (#183)
 

+* fixed multiline strings being unnecessarily wrapped in optional
+  parentheses in long assignments (#215)
+

 * fixed not splitting long from-imports with only a single name
 
 * fixed Python 3.6+ file discovery by also looking at function calls with
 * fixed not splitting long from-imports with only a single name
 
 * fixed Python 3.6+ file discovery by also looking at function calls with