summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorNatalia <124304+nessita@users.noreply.github.com>2026-05-25 16:05:36 -0300
committernessita <124304+nessita@users.noreply.github.com>2026-05-26 15:06:36 -0300
commit3be19dcd89da43b5f3a5dc90a4259c0f9410c093 (patch)
tree016be563a83df5c9f1bcbc3e37f551df8942d019 /docs/ref
parent95514247d86ebe0a1582d1fa7a9ffc314ac514f4 (diff)
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.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/settings.txt12
1 files changed, 9 insertions, 3 deletions
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