summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/internals/deprecation.txt3
-rw-r--r--docs/releases/6.1.txt17
2 files changed, 20 insertions, 0 deletions
diff --git a/docs/internals/deprecation.txt b/docs/internals/deprecation.txt
index 280187b368..8962cbde62 100644
--- a/docs/internals/deprecation.txt
+++ b/docs/internals/deprecation.txt
@@ -64,6 +64,9 @@ details on these changes.
:class:`~django.db.models.JSONNull` to query for a JSON ``null`` value
instead.
+* The ``Field.get_placeholder_sql`` shim over the deprecated
+ ``get_placeholder`` method will be removed.
+
.. _deprecation-removed-in-6.1:
6.1
diff --git a/docs/releases/6.1.txt b/docs/releases/6.1.txt
index 2539e599c7..67891c5bf7 100644
--- a/docs/releases/6.1.txt
+++ b/docs/releases/6.1.txt
@@ -396,6 +396,15 @@ backends.
* Set the new ``DatabaseFeatures.supports_inspectdb`` attribute to ``False``
if the management command isn't supported.
+* The ``DatabaseOperations.binary_placeholder_sql()`` method now expects a
+ query compiler as an extra positional argument and should return a
+ two-elements tuple composed of an SQL format string and a tuple of associated
+ parameters.
+
+* The ``BaseSpatialOperations.get_geom_placeholder()`` method is renamed to
+ ``get_geom_placeholder_sql`` and is expected to return a two-elements tuple
+ composed of an SQL format string and a tuple of associated parameters.
+
:mod:`django.contrib.admin`
---------------------------
@@ -481,6 +490,14 @@ Miscellaneous
used as the top-level value. :lookup:`Key and index lookups <jsonfield.key>`
are unaffected by this deprecation.
+* The undocumented ``get_placeholder`` method of
+ :class:`~django.db.models.Field` is deprecated in favor of the newly
+ introduced ``get_placeholder_sql`` method, which has the same input signature
+ but is expected to return a two-elements tuple composed of an SQL format
+ string and a tuple of associated parameters. This method should now expect
+ to be provided expressions meant to be compiled via the provided ``compiler``
+ argument.
+
Features removed in 6.1
=======================