Clarify that Black runs with --safe by default (#3378)
This commit is contained in:
parent
8091b2503d
commit
c23a5c15aa
@ -457,9 +457,9 @@ the latter are treated as true raw strings with no special semantics.
|
|||||||
|
|
||||||
### AST before and after formatting
|
### AST before and after formatting
|
||||||
|
|
||||||
When run with `--safe`, _Black_ checks that the code before and after is semantically
|
When run with `--safe` (the default), _Black_ checks that the code before and after is
|
||||||
equivalent. This check is done by comparing the AST of the source with the AST of the
|
semantically equivalent. This check is done by comparing the AST of the source with the
|
||||||
target. There are three limited cases in which the AST does differ:
|
AST of the target. There are three limited cases in which the AST does differ:
|
||||||
|
|
||||||
1. _Black_ cleans up leading and trailing whitespace of docstrings, re-indenting them if
|
1. _Black_ cleans up leading and trailing whitespace of docstrings, re-indenting them if
|
||||||
needed. It's been one of the most popular user-reported features for the formatter to
|
needed. It's been one of the most popular user-reported features for the formatter to
|
||||||
|
Loading…
Reference in New Issue
Block a user