vim plugin: Add quiet flag so non-error actions go unreported (#1733)

[etc/vim.git] / docs / version_control_integration.md

diff --git a/docs/version_control_integration.md b/docs/version_control_integration.md
index 25dac308c47c355f735eb322e543495cacf35d56..0e09854a2e5e1a8f194e508b6dd18c96630203fb 100644 (file)
--- a/docs/version_control_integration.md
+++ b/docs/version_control_integration.md
@@ -9,7 +9,7 @@ Use [pre-commit](https://pre-commit.com/). Once you
 ```yaml
 repos:
   - repo: https://github.com/psf/black
-    rev: 19.10b0 # Replace by any tag/version: https://github.com/psf/black/tags
+    rev: 20.8b1 # Replace by any tag/version: https://github.com/psf/black/tags
     hooks:
       - id: black
         language_version: python3 # Should be a command that runs python3.6+
@@ -23,6 +23,11 @@ for your project. See _Black_'s own
 [pyproject.toml](https://github.com/psf/black/blob/master/pyproject.toml) for an
 example.
 
+When using the `--diff` flag with `pre-commit`, you must also use the `--check` flag.
+When you want to run _Black_ only on specific files in pre-commit, either use
+pre-commit's own `files` and `exclude` or, when using _Black_'s `--include`, set
+`--force-exclude` to the negated regex of `--include`.
+
 If you're already using Python 3.7, switch the `language_version` accordingly. Finally,
 `stable` is a branch that tracks the latest release on PyPI. If you'd rather run on
 master, this is also an option.