From 7f3210efa8b4bfb34a3feebae7bb08c26f4a65a7 Mon Sep 17 00:00:00 2001 From: Gabriel Hurley Date: Wed, 29 Dec 2010 00:03:02 +0000 Subject: [PATCH] Fixed #14403 -- Provided some extra resources on the difference between FloatField and DecimalField in the model field reference. Thanks to typeshige for the report and trebor74hr and dmedvinsky for the draft patch. git-svn-id: http://code.djangoproject.com/svn/django/trunk@15090 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/ref/models/fields.txt | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt index 2dd429c250631..0399eccf67304 100644 --- a/docs/ref/models/fields.txt +++ b/docs/ref/models/fields.txt @@ -455,6 +455,12 @@ decimal places:: The admin represents this as an ```` (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 `. + ``EmailField`` -------------- @@ -661,6 +667,20 @@ A floating-point number represented in Python by a ``float`` instance. The admin represents this as an ```` (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`` --------------