Ticket #14638: 14638.diff

docs/howto/custom-model-fields.txt

@@ -362 +362 @@
     class HandField(with_metaclass(models.SubfieldBase, models.Field)):
         ...
 
-This ensures that the :meth:`.to_python` method, documented below, will always
+This ensures that the :meth:`.to_python` method, will always
 be called when the attribute is initialized.
 
 ModelForms and custom fields
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you use :class:`~django.db.models.SubfieldBase`, :meth:`.to_python`
-will be called every time an instance of the field is assigned a
+apart from its usual call when getting the value from the database,
+will also be called every time an instance of the field is assigned a
 value. This means that whenever a value may be assigned to the field,
 you need to ensure that it will be of the correct datatype, or that
 you handle any exceptions.

docs/ref/models/fields.txt

@@ -1615 +1615 @@
         The default implementation returns ``value``, which is the common case
         when the database backend already returns the correct Python type.
 
-        See :ref:`converting-database-values-to-python-objects` for usage.
+        See :ref:`converting-database-values-to-python-objects` for various usages.
 
     When saving, :meth:`pre_save` and :meth:`get_db_prep_save` are used: