From b965c2a5026f8ba399283ba3e01898b012853c79 Mon Sep 17 00:00:00 2001
From: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Date: Fri, 2 Aug 2024 09:38:22 -0700
Subject: [PATCH] Prepare release 24.8.0 (#4426)

---
 CHANGES.md                                  | 39 +--------------------
 docs/integrations/source_version_control.md |  4 +--
 docs/usage_and_configuration/the_basics.md  |  6 ++--
 3 files changed, 6 insertions(+), 43 deletions(-)

diff --git a/CHANGES.md b/CHANGES.md
index 00508eb9d32..f7377e5baea 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -1,72 +1,35 @@
 # Change Log
 
-## Unreleased
-
-### Highlights
-
-<!-- Include any especially major or disruptive changes here -->
+## 24.8.0
 
 ### Stable style
 
-<!-- Changes that affect Black's stable style -->
-
 - Fix crash when `# fmt: off` is used before a closing parenthesis or bracket. (#4363)
 
-### Preview style
-
-<!-- Changes that affect Black's preview style -->
-
-### Configuration
-
-<!-- Changes to how Black can be configured -->
-
 ### Packaging
 
-<!-- Changes to how Black is packaged, such as dependency requirements -->
-
 - Packaging metadata updated: docs are explictly linked, the issue tracker is now also
   linked. This improves the PyPI listing for Black. (#4345)
 
 ### Parser
 
-<!-- Changes to the parser or to version autodetection -->
-
 - Fix regression where Black failed to parse a multiline f-string containing another
   multiline string (#4339)
-
 - Fix regression where Black failed to parse an escaped single quote inside an f-string
   (#4401)
-
 - Fix bug with Black incorrectly parsing empty lines with a backslash (#4343)
-
 - Fix bugs with Black's tokenizer not handling `\{` inside f-strings very well (#4422)
-
 - Fix incorrect line numbers in the tokenizer for certain tokens within f-strings
   (#4423)
 
 ### Performance
 
-<!-- Changes that improve Black's performance. -->
-
 - Improve performance when a large directory is listed in `.gitignore` (#4415)
 
-### Output
-
-<!-- Changes to Black's terminal output and error messages -->
-
 ### _Blackd_
 
 - Fix blackd (and all extras installs) for docker container (#4357)
 
-### Integrations
-
-<!-- For example, Docker, GitHub Actions, pre-commit, editors -->
-
-### Documentation
-
-<!-- Major changes to documentation and policies. Small docs changes
-     don't need a changelog entry. -->
-
 ## 24.4.2
 
 This is a bugfix release to fix two regressions in the new f-string parser introduced in
diff --git a/docs/integrations/source_version_control.md b/docs/integrations/source_version_control.md
index bbbd257c9d2..f66b5e00a77 100644
--- a/docs/integrations/source_version_control.md
+++ b/docs/integrations/source_version_control.md
@@ -8,7 +8,7 @@ Use [pre-commit](https://pre-commit.com/). Once you
 repos:
   # Using this mirror lets us use mypyc-compiled black, which is about 2x faster
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.4.2
+    rev: 24.8.0
     hooks:
       - id: black
         # It is recommended to specify the latest version of Python
@@ -35,7 +35,7 @@ include Jupyter Notebooks. To use this hook, simply replace the hook's `id: blac
 repos:
   # Using this mirror lets us use mypyc-compiled black, which is about 2x faster
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.4.2
+    rev: 24.8.0
     hooks:
       - id: black-jupyter
         # It is recommended to specify the latest version of Python
diff --git a/docs/usage_and_configuration/the_basics.md b/docs/usage_and_configuration/the_basics.md
index b468a04c499..7b5da98879f 100644
--- a/docs/usage_and_configuration/the_basics.md
+++ b/docs/usage_and_configuration/the_basics.md
@@ -269,8 +269,8 @@ configuration file for consistent results across environments.
 
 ```console
 $ black --version
-black, 24.4.2 (compiled: yes)
-$ black --required-version 24.4.2 -c "format = 'this'"
+black, 24.8.0 (compiled: yes)
+$ black --required-version 24.8.0 -c "format = 'this'"
 format = "this"
 $ black --required-version 31.5b2 -c "still = 'beta?!'"
 Oh no! 💥 💔 💥 The required version does not match the running version!
@@ -366,7 +366,7 @@ You can check the version of _Black_ you have installed using the `--version` fl
 
 ```console
 $ black --version
-black, 24.4.2
+black, 24.8.0
 ```
 
 #### `--config`