From ebd3e391dab8d97ce7dbd837473641ddd5fb51c0 Mon Sep 17 00:00:00 2001 From: Jelle Zijlstra Date: Tue, 30 Nov 2021 12:34:45 -0800 Subject: [PATCH] add FAQ entry about undetected syntax errors (#2645) This came up in #2644. --- docs/faq.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/faq.md b/docs/faq.md index 88bf35b1e6a..0a966c99c7f 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -94,7 +94,14 @@ them in the right place, this detection is not and cannot be perfect. Therefore, sometimes have to manually move these comments to the right place after you format your codebase with _Black_. -## Can I run black with PyPy? +## Can I run Black with PyPy? Yes, there is support for PyPy 3.7 and higher. You cannot format Python 2 files under PyPy, because PyPy's inbuilt ast module does not support this. + +## Why does Black not detect syntax errors in my code? + +_Black_ is an autoformatter, not a Python linter or interpreter. Detecting all syntax +errors is not a goal. It can format all code accepted by CPython (if you find an example +where that doesn't hold, please report a bug!), but it may also format some code that +CPython doesn't accept.