summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorjunghwan16 <chotnt741@gmail.com>2025-05-31 16:32:13 +0900
committerSarah Boyce <42296566+sarahboyce@users.noreply.github.com>2025-06-11 10:00:21 +0200
commit91569cffeccf03756bb9217c46e1b18591213d6a (patch)
tree3d7b71f0d806064ca7d9a8bb45db605773b22437 /docs
parent329a5c9228b7d1752830d3af1a7c602056b82156 (diff)
[5.2.x] Fixed #36425 -- Standardized integer fields descriptions.
Backport of 091f66e51aa900f7d7650529621bdc8e4b0dee68 from main.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/models/fields.txt22
1 files changed, 12 insertions, 10 deletions
diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt
index faaa8babd8..511b6e0215 100644
--- a/docs/ref/models/fields.txt
+++ b/docs/ref/models/fields.txt
@@ -1405,7 +1405,8 @@ The default form widget for this field is a
.. class:: IntegerField(**options)
-An integer. Values from ``-2147483648`` to ``2147483647`` are safe in all
+An integer. Values are only allowed between certain (database-dependent)
+points. Values from ``-2147483648`` to ``2147483647`` are compatible in all
databases supported by Django.
It uses :class:`~django.core.validators.MinValueValidator` and
@@ -1489,7 +1490,7 @@ To query ``JSONField`` in the database, see :ref:`querying-jsonfield`.
Like a :class:`PositiveIntegerField`, but only allows values under a certain
(database-dependent) point. Values from ``0`` to ``9223372036854775807`` are
-safe in all databases supported by Django.
+compatible in all databases supported by Django.
``PositiveIntegerField``
------------------------
@@ -1497,8 +1498,9 @@ safe in all databases supported by Django.
.. class:: PositiveIntegerField(**options)
Like an :class:`IntegerField`, but must be either positive or zero (``0``).
-Values from ``0`` to ``2147483647`` are safe in all databases supported by
-Django. The value ``0`` is accepted for backward compatibility reasons.
+Values are only allowed under a certain (database-dependent) point. Values from
+``0`` to ``2147483647`` are compatible in all databases supported by Django.
+The value ``0`` is accepted for backward compatibility reasons.
``PositiveSmallIntegerField``
-----------------------------
@@ -1506,8 +1508,8 @@ Django. The value ``0`` is accepted for backward compatibility reasons.
.. class:: PositiveSmallIntegerField(**options)
Like a :class:`PositiveIntegerField`, but only allows values under a certain
-(database-dependent) point. Values from ``0`` to ``32767`` are safe in all
-databases supported by Django.
+(database-dependent) point. Values from ``0`` to ``32767`` are compatible in
+all databases supported by Django.
``SlugField``
-------------
@@ -1543,8 +1545,8 @@ It uses :class:`~django.core.validators.validate_slug` or
.. class:: SmallAutoField(**options)
Like an :class:`AutoField`, but only allows values under a certain
-(database-dependent) limit. Values from ``1`` to ``32767`` are safe in all
-databases supported by Django.
+(database-dependent) limit. Values from ``1`` to ``32767`` are compatible in
+all databases supported by Django.
``SmallIntegerField``
---------------------
@@ -1552,8 +1554,8 @@ databases supported by Django.
.. class:: SmallIntegerField(**options)
Like an :class:`IntegerField`, but only allows values under a certain
-(database-dependent) point. Values from ``-32768`` to ``32767`` are safe in all
-databases supported by Django.
+(database-dependent) point. Values from ``-32768`` to ``32767`` are compatible
+in all databases supported by Django.
``TextField``
-------------