From 3be19dcd89da43b5f3a5dc90a4259c0f9410c093 Mon Sep 17 00:00:00 2001
From: Natalia <124304+nessita@users.noreply.github.com>
Date: Mon, 25 May 2026 16:05:36 -0300
Subject: Refs #35870 -- Moved deprecated notice at the bottom for
 USE_BLANK_CHOICE_DASH.

Also expended a bit on details for the setting so readers know what is
it about.
---
 docs/ref/settings.txt | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

(limited to 'docs')

diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index 95cdb217f0..026d1b01a9 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -3186,12 +3186,18 @@ the correct environment.
 ------------------------------------
 
 .. versionadded:: 6.1
-.. deprecated:: 6.1
 
 Default: ``False``
 
-Set this transitional setting to ``True`` to revert back to the old default
-blank choice label in forms.
+The default blank choice label in ``Select`` widgets was changed from
+``"---------"`` to ``django.db.models.fields.BLANK_CHOICE_LABEL``. Set this
+transitional setting to ``True`` to revert to the previous label.
+
+.. deprecated:: 6.1
+
+    This setting will be removed in Django 7.0. To use a custom default blank
+    choice label, override ``django.db.models.fields.BLANK_CHOICE_LABEL`` in
+    the app's ``ready()`` method.
 
 .. setting:: USE_I18N
 
-- 
cgit v1.3