Clarify that Black runs with --safe by default (#3378)

This commit is contained in:
Maximilian Cosmo Sitter 2022-11-10 16:03:19 +01:00 committed by Richard Si
parent 8091b2503d
commit c23a5c15aa
No known key found for this signature in database
GPG Key ID: 33F737A005EDF2DF

View File

@ -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