X-Git-Url: https://git.madduck.net/etc/vim.git/blobdiff_plain/25d24a10a4f4cdf81b7335615c74f285127b1a04..44e9cd4a03df470adb24b958ae4b9e47ee890315:/README.md diff --git a/README.md b/README.md index 192f47e..fa5382c 100644 --- a/README.md +++ b/README.md @@ -81,6 +81,8 @@ Options: source on standard input). -S, --skip-string-normalization Don't normalize string quotes or prefixes. + -N, --skip-numeric-underscore-normalization + Don't normalize underscores in numeric literals. --check Don't write the files back, just return the status. Return code 0 means nothing would change. Return code 1 means some files would be @@ -141,7 +143,8 @@ original. This slows it down. If you're feeling confident, use *Black* reformats entire files in place. It is not configurable. It doesn't take previous formatting into account. It doesn't reformat -blocks that start with `# fmt: off` and end with `# fmt: on`. It also +blocks that start with `# fmt: off` and end with `# fmt: on`. `# fmt: on/off` +have to be on the same level of indentation. It also recognizes [YAPF](https://github.com/google/yapf)'s block comments to the same effect, as a courtesy for straddling code. @@ -544,6 +547,8 @@ other file. If you're running with `--verbose`, you will see a blue message if a file was found and used. +Please note `blackd` will not use `pyproject.toml` configuration. + ### Configuration format @@ -938,16 +943,23 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md). * code with `_` in numeric literals is recognized as Python 3.6+ - * most letters in numeric literals are lowercased (e.g., in `1e10` or `0xab`) + * most letters in numeric literals are lowercased (e.g., in `1e10`, `0x01`) + + * hexadecimal digits are always uppercased (e.g. `0xBADC0DE`) * added `blackd`, see [its documentation](#blackd) for more info (#349) * adjacent string literals are now correctly split into multiple lines (#463) +* trailing comma is now added to single imports that don't fit on a line (#250) + * cache is now populated when `--check` is successful for a file which speeds up consecutive checks of properly formatted unmodified files (#448) -* code with `_` in numeric literals is recognized as Python 3.6+ (#461) +* whitespace at the beginning of the file is now removed (#399) + +* fixed mangling [pweave](http://mpastell.com/pweave/) and + [Spyder IDE](https://pythonhosted.org/spyder/) special comments (#532) * fixed unstable formatting when unpacking big tuples (#267) @@ -964,9 +976,6 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md). to be a bad idea (#415) -* trailing comma is now added to single imports that don't fit on a line (#250) - - ### 18.6b4 * hotfix: don't freeze when multiple comments directly precede `# fmt: off` (#371)