From 03bfcbad88a1ab8a29504a7a0eb9d7c31745c9c5 Mon Sep 17 00:00:00 2001 From: xncbf Date: Sun, 17 May 2020 16:54:26 +0900 Subject: [PATCH] [3.1.x] Fixed #31577 -- Clarified docs about bounds of RangeFields. Backport of 4029bcd6b20f75a78f9a5829d7826c79aeb20732 from master --- AUTHORS | 1 + docs/ref/contrib/postgres/fields.txt | 11 +++++++---- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/AUTHORS b/AUTHORS index 9165388f58f..05be5d870c4 100644 --- a/AUTHORS +++ b/AUTHORS @@ -509,6 +509,7 @@ answer newbie questions, and generally made Django that much better: Kevin McConnell Kieran Holland kilian + Kim Joon Hwan 김준환 Klaas van Schelven knox konrad@gwu.edu diff --git a/docs/ref/contrib/postgres/fields.txt b/docs/ref/contrib/postgres/fields.txt index aeacc72e7c9..198ef1c284d 100644 --- a/docs/ref/contrib/postgres/fields.txt +++ b/docs/ref/contrib/postgres/fields.txt @@ -538,7 +538,10 @@ suitable for. All of the range fields translate to :ref:`psycopg2 Range objects ` in Python, but also accept tuples as input if no bounds information is necessary. The default is lower bound included, upper bound -excluded; that is, ``[)``. +excluded, that is ``[)`` (see the PostgreSQL documentation for details about +`different bounds`_). + +.. _different bounds: https://www.postgresql.org/docs/current/rangetypes.html#RANGETYPES-IO ``IntegerRangeField`` --------------------- @@ -552,7 +555,7 @@ excluded; that is, ``[)``. Regardless of the bounds specified when saving the data, PostgreSQL always returns a range in a canonical form that includes the lower bound and - excludes the upper bound; that is ``[)``. + excludes the upper bound, that is ``[)``. ``BigIntegerRangeField`` ------------------------ @@ -566,7 +569,7 @@ excluded; that is, ``[)``. Regardless of the bounds specified when saving the data, PostgreSQL always returns a range in a canonical form that includes the lower bound and - excludes the upper bound; that is ``[)``. + excludes the upper bound, that is ``[)``. ``DecimalRangeField`` --------------------- @@ -599,7 +602,7 @@ excluded; that is, ``[)``. Regardless of the bounds specified when saving the data, PostgreSQL always returns a range in a canonical form that includes the lower bound and - excludes the upper bound; that is ``[)``. + excludes the upper bound, that is ``[)``. Querying Range Fields ---------------------