Document cache location configuration (#866)

[etc/vim.git] / README.md

diff --git a/README.md b/README.md
index 66e863377b59382c1c20be5e21ae511ecb561e0e..76b7d7cafd770cb410071035861975fce5ed338e 100644 (file)
--- a/README.md
+++ b/README.md
@@ -844,6 +844,14 @@ Options:
   -h, --help                      Show this message and exit.
 ```
 
+There is no official blackd client tool (yet!). You can test that blackd is
+working using `curl`:
+
+```
+blackd --bind-port 9090 &  # or let blackd choose a port
+curl -s -XPOST "localhost:9090" -d "print('valid')"
+```
+
 ### Protocol
 
 `blackd` only accepts `POST` requests at the `/` path. The body of the request
@@ -925,6 +933,10 @@ is:
 `file-mode` is an int flag that determines whether the file was formatted as 3.6+ only,
 as .pyi, and whether string normalization was omitted.
 
+To override the location of these files on macOS or Linux, set the environment variable
+`XDG_CACHE_HOME` to your preferred location. For example, if you want to put the cache in
+the directory you're running *Black* from, set `XDG_CACHE_HOME=.cache`. *Black* will then
+write the above files to `.cache/black/<version>/`.
 
 ## Used by
 
@@ -998,29 +1010,37 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md).
 
 ### 19.5b0
 
-* don't crash when run on a Windows machine with more than 61 cores (#838)
+* added `black -c` as a way to format code passed from the command line
+  (#761)
 
-* remove unnecessary parentheses around `yield` expressions (#834)
+* --safe now works with Python 2 code (#840)
 
-* add parentheses around long tuples in unpacking assignments (#832)
+* fixed grammar selection for Python 2-specific code (#765)
 
-* don't produce invalid code for `from` ... `import` blocks with comments
-  (#829)
+* fixed feature detection for trailing commas in function definitions
+  and call sites (#763)
+
+* *Black* can now format async generators (#593)
+
+* *Black* no longer crashes on Windows machines with more than 61 cores
+  (#838)
 
-* fix grammar selection (#765)
+* *Black* no longer crashes on standalone comments prepended with
+  a backslash (#767)
 
-* fix feature detection for trailing commas in function definitions and
-  call sites (#763)
+* *Black* no longer crashes on `from` ... `import` blocks with comments
+  (#829)
 
-* add `black -c` as a way to format code passed from the command line (#761)
+* removed unnecessary parentheses around `yield` expressions (#834)
 
-* fix bug that led *Black* format some code with a line length target of 1
-  (#762)
+* added parentheses around long tuples in unpacking assignments (#832)
 
-* --safe now works with Python 2 code (#840)
+* fixed bug that led *Black* format some code with a line length target
+  of 1 (#762)
+
+* *Black* no longer introduces quotes in f-string subexpressions on string
+  boundaries (#863)
 
-* *Black* no longer crashes on standalone comments prepended with
-  a backslash (#767)
 
 ### 19.3b0
 
@@ -1048,6 +1068,7 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md).
 
 * `blackd` now supports CORS (#622)
 
+
 ### 18.9b0
 
 * numeric literals are now formatted by *Black* (#452, #461, #464, #469):
@@ -1451,6 +1472,7 @@ Maintained with [Carol Willing](mailto:carolcode@willingconsulting.com),
 Multiple contributions by:
 * [Anthony Sottile](mailto:asottile@umich.edu)
 * [Artem Malyshev](mailto:proofit404@gmail.com)
+* [Benjamin Woodruff](mailto:github@benjam.info)
 * [Christian Heimes](mailto:christian@python.org)
 * [Daniel M. Capella](mailto:polycitizen@gmail.com)
 * [Eli Treuherz](mailto:eli@treuherz.com)