From: Maximilian Cosmo Sitter <48606431+mcsitter@users.noreply.github.com> Date: Thu, 10 Nov 2022 15:03:19 +0000 (+0100) Subject: Clarify that Black runs with --safe by default (#3378) X-Git-Url: https://git.madduck.net/etc/vim.git/commitdiff_plain/c23a5c15aac963b460fdb1327ae875aafafafd41?ds=sidebyside Clarify that Black runs with --safe by default (#3378) --- diff --git a/docs/the_black_code_style/current_style.md b/docs/the_black_code_style/current_style.md index 59d79c4..0f166fe 100644 --- a/docs/the_black_code_style/current_style.md +++ b/docs/the_black_code_style/current_style.md @@ -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