Permalink
Browse files

[1.2.X] Fixed #14403 -- Provided some extra resources on the differen…

…ce between FloatField and DecimalField in the model field reference. Thanks to typeshige for the report and trebor74hr and dmedvinsky for the draft patch.

Backport of [15090] from trunk.

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.2.X@15091 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent a3169e3 commit 8db865c8fbf7242cbdfe5629fda66564762900ee Gabriel Hurley committed Dec 29, 2010
Showing with 20 additions and 0 deletions.
  1. +20 −0 docs/ref/models/fields.txt
View
20 docs/ref/models/fields.txt
@@ -455,6 +455,12 @@ decimal places::
The admin represents this as an ``<input type="text">`` (a single-line input).
+.. note::
+
+ For more information about the differences between the
+ :class:`FloatField` and :class:`DecimalField` classes, please
+ see :ref:`FloatField vs. DecimalField <floatfield_vs_decimalfield>`.
+
``EmailField``
--------------
@@ -661,6 +667,20 @@ A floating-point number represented in Python by a ``float`` instance.
The admin represents this as an ``<input type="text">`` (a single-line input).
+.. _floatfield_vs_decimalfield:
+
+.. admonition:: ``FloatField`` vs. ``DecimalField``
+
+ The :class:`FloatField` class is sometimes mixed up with the
+ :class:`DecimalField` class. Although they both represent real numbers, they
+ represent those numbers differently. ``FloatField`` uses Python's ``float``
+ type internally, while ``DecimalField`` uses Python's ``Decimal`` type. For
+ information on the difference between the two, see Python's documentation on
+ `Decimal fixed point and floating point arithmetic`_.
+
+.. _Decimal fixed point and floating point arithmetic: http://docs.python.org/library/decimal.html
+
+
``ImageField``
--------------

0 comments on commit 8db865c

Please sign in to comment.