Ticket #9853: field_normalization.diff

docs/ref/models/fields.txt

@@ -365 +365 @@
 
 .. class:: DateField([auto_now=False, auto_now_add=False, **options])
 
-A date field. Has a few extra optional arguments:
+A date field. Normalizes to a Python ``datetime.date`` object. Has a few extra
+optional arguments:
 
 .. attribute:: DateField.auto_now
 
@@ -388 +389 @@
 
 .. class:: DateTimeField([auto_now=False, auto_now_add=False, **options])
 
-A date and time field. Takes the same extra options as :class:`DateField`.
+A date and time field. Normalizes to a Python ``datetime.datetime`` object.
+Takes the same extra options as :class:`DateField`.
 
 The admin represents this as two ``<input type="text">`` fields, with JavaScript
 shortcuts.
@@ -706 +708 @@
 
 .. class:: TimeField([auto_now=False, auto_now_add=False, **options])
 
-A time. Accepts the same auto-population options as :class:`DateField` and
-:class:`DateTimeField`. The admin represents this as an ``<input type="text">``
-with some JavaScript shortcuts.
+A time field. Normalizes to a Python ``datetime.time`` object. Accepts the same
+auto-population options as :class:`DateField` and :class:`DateTimeField`. The
+admin represents this as an ``<input type="text">`` with some JavaScript
+shortcuts.
 
 ``URLField``
 ------------