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
|
||||
|
||||
When run with `--safe`, _Black_ checks that the code before and after is semantically
|
||||
equivalent. This check is done by comparing the AST of the source with the AST of the
|
||||
target. There are three limited cases in which the AST does differ:
|
||||
When run with `--safe` (the default), _Black_ checks that the code before and after is
|
||||
semantically equivalent. This check is done by comparing the AST of the source with the
|
||||
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
|
||||
needed. It's been one of the most popular user-reported features for the formatter to
|
||||
|
Loading…
Reference in New Issue
Block a user