separate CHANGELOG section for preview style (#2890)

[etc/vim.git] / CHANGES.md

diff --git a/CHANGES.md b/CHANGES.md
index 6775cee14e80f481ab3c14b39ea4230f2a6d8854..5f9341d048c66fe3b7274ef3649e2fce59ff4db8 100644 (file)
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -2,8 +2,62 @@
 
 ## Unreleased
 
+### Highlights
+
+<!-- Include any especially major or disruptive changes here -->
+
+### Style
+
+<!-- Changes that affect Black's stable style -->
+
+### Preview style
+
+<!-- Changes that affect Black's preview style -->
+
+### _Blackd_
+
+<!-- Changes to blackd -->
+
+### Configuration
+
+<!-- Changes to how Black can be configured -->
+
+- Do not format `__pypackages__` directories by default (#2836)
+- Add support for specifying stable version with `--required-version` (#2832).
+- Avoid crashing when the user has no homedir (#2814)
+
+### Documentation
+
+<!-- Major changes to documentation and policies. Small docs changes
+     don't need a changelog entry. -->
+
+### Integrations
+
+<!-- For example, Docker, GitHub Actions, pre-commit, editors -->
+
+### Output
+
+<!-- Changes to Black's terminal output and error messages -->
+
+- In verbose, mode, log when _Black_ is using user-level config (#2861)
+
+### Packaging
+
+<!-- Changes to how Black is packaged, such as dependency requirements -->
+
+### Parser
+
+<!-- Changes to the parser or to version autodetection -->
+
+### Performance
+
+<!-- Changes that improve Black's performance. -->
+
+## 22.1.0
+
 At long last, _Black_ is no longer a beta product! This is the first non-beta release
-and the first release covered by our new stability policy.
+and the first release covered by our new
+[stability policy](https://black.readthedocs.io/en/stable/the_black_code_style/index.html#stability-policy).
 
 ### Highlights
 
@@ -25,6 +79,7 @@ and the first release covered by our new stability policy.
   literals (#2799)
 - Treat blank lines in stubs the same inside top-level `if` statements (#2820)
 - Fix unstable formatting with semicolons and arithmetic expressions (#2817)
+- Fix unstable formatting around magic trailing comma (#2572)
 
 ### Parser
 
@@ -39,6 +94,7 @@ and the first release covered by our new stability policy.
   `values: Tuple[int, ...] = 1, 2, 3`) now implies 3.8+ (#2708)
 - Fix handling of standalone `match()` or `case()` when there is a trailing newline or a
   comment inside of the parentheses. (#2760)
+- `from __future__ import annotations` statement now implies Python 3.7+ (#2690)
 
 ### Performance
 
@@ -95,7 +151,6 @@ and the first release covered by our new stability policy.
 - Fix determination of f-string expression spans (#2654)
 - Fix bad formatting of error messages about EOF in multi-line statements (#2343)
 - Functions and classes in blocks now have more consistent surrounding spacing (#2472)
-- `from __future__ import annotations` statement now implies Python 3.7+ (#2690)
 
 #### Jupyter Notebook support
 
@@ -139,7 +194,6 @@ and the first release covered by our new stability policy.
   when `--target-version py310` is explicitly specified (#2586)
 - Add support for parenthesized with (#2586)
 - Declare support for Python 3.10 for running Black (#2562)
-- Fix unstable black runs around magic trailing comma (#2572)
 
 ### Integrations