summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/models/querysets.txt10
-rw-r--r--docs/releases/5.2.txt8
-rw-r--r--docs/spelling_wordlist1
3 files changed, 18 insertions, 1 deletions
diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt
index 7a0d086bfe..d708e05a79 100644
--- a/docs/ref/models/querysets.txt
+++ b/docs/ref/models/querysets.txt
@@ -745,6 +745,11 @@ You can also refer to fields on related models with reverse relations through
``"true"``, ``"false"``, and ``"null"`` strings for
:class:`~django.db.models.JSONField` key transforms.
+.. versionchanged:: 5.2
+
+ The ``SELECT`` clause generated when using ``values()`` was updated to
+ respect the order of the specified ``*fields`` and ``**expressions``.
+
``values_list()``
~~~~~~~~~~~~~~~~~
@@ -835,6 +840,11 @@ not having any author:
``"true"``, ``"false"``, and ``"null"`` strings for
:class:`~django.db.models.JSONField` key transforms.
+.. versionchanged:: 5.2
+
+ The ``SELECT`` clause generated when using ``values_list()`` was updated to
+ respect the order of the specified ``*fields``.
+
``dates()``
~~~~~~~~~~~
diff --git a/docs/releases/5.2.txt b/docs/releases/5.2.txt
index bdc5349368..5d5887fe34 100644
--- a/docs/releases/5.2.txt
+++ b/docs/releases/5.2.txt
@@ -195,7 +195,13 @@ Migrations
Models
~~~~~~
-* ...
+* The ``SELECT`` clause generated when using
+ :meth:`QuerySet.values()<django.db.models.query.QuerySet.values>` and
+ :meth:`~django.db.models.query.QuerySet.values_list` now matches the
+ specified order of the referenced expressions. Previously the order was based
+ of a set of counterintuitive rules which made query combination through
+ methods such as
+ :meth:`QuerySet.union()<django.db.models.query.QuerySet.union>` unpredictable.
Requests and Responses
~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/spelling_wordlist b/docs/spelling_wordlist
index 1044cd80eb..d715e62e05 100644
--- a/docs/spelling_wordlist
+++ b/docs/spelling_wordlist
@@ -96,6 +96,7 @@ contenttypes
contrib
coroutine
coroutines
+counterintuitive
criticals
cron
crontab