Document string prefix standardization

diff --git a/README.md b/README.md
index 00c8ee418ec3a89f30fa3b0b127c054bdf327cfe..0571a9796dfa386f4fd72af1745d1032fe01185d 100644 (file)
--- a/README.md
+++ b/README.md
@@ -274,6 +274,11 @@ keep it.
 and `'''`).  It will replace the latter with the former as long as it
 does not result in more backslash escapes than before.
 
 and `'''`).  It will replace the latter with the former as long as it
 does not result in more backslash escapes than before.
 

+*Black* also standardizes string prefixes, making them always lowercase.
+On top of that, if your code is already Python 3.6+ only or it's using
+the `unicode_literals` future import, *Black* will remove `u` from the
+string prefix as it is meaningless in those scenarios.
+

 The main reason to standardize on a single form of quotes is aesthetics.
 Having one kind of quotes everywhere reduces reader distraction.
 It will also enable a future version of *Black* to merge consecutive
 The main reason to standardize on a single form of quotes is aesthetics.
 Having one kind of quotes everywhere reduces reader distraction.
 It will also enable a future version of *Black* to merge consecutive


@@ -557,6 +562,10 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md).
 
 * empty parentheses in a class definition are now removed (#145, #180)
 
 
 * empty parentheses in a class definition are now removed (#145, #180)
 

+* string prefixes are now standardized to lowercase and `u` is removed
+  on Python 3.6+ only code and Python 2.7+ code with the `unicode_literals`
+  future import (#188, #198, #199)
+

 * fixed an invalid trailing comma sometimes left in imports (#185)
 
 * fixed non-deterministic formatting when multiple pairs of removable parentheses
 * fixed an invalid trailing comma sometimes left in imports (#185)
 
 * fixed non-deterministic formatting when multiple pairs of removable parentheses