summaryrefslogtreecommitdiff
path: root/docs/ref/models
diff options
context:
space:
mode:
authorAdrian Holovaty <adrian@holovaty.com>2010-01-09 18:07:28 +0000
committerAdrian Holovaty <adrian@holovaty.com>2010-01-09 18:07:28 +0000
commitd8b7772fca793aa734df603d745a42a558b3bdc3 (patch)
tree0869124e3452176df53205adb4bd3d0f02a4297e /docs/ref/models
parent50bfa46c39d05d351ae77559d54fa8cab3e4f743 (diff)
Made some edits to the validation part of docs/ref/models/instances.txt
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12124 bcc190cf-cafb-0310-a4f2-bffc1f526a37
Diffstat (limited to 'docs/ref/models')
-rw-r--r--docs/ref/models/instances.txt23
1 files changed, 11 insertions, 12 deletions
diff --git a/docs/ref/models/instances.txt b/docs/ref/models/instances.txt
index 242caa8efd..9b720bec56 100644
--- a/docs/ref/models/instances.txt
+++ b/docs/ref/models/instances.txt
@@ -34,31 +34,30 @@ Validating objects
.. versionadded:: 1.2
-To validate your model, just call its ``full_validate()`` method:
+To validate your model, call its ``full_validate()`` method:
.. method:: Model.full_validate([exclude=[]])
-The optional ``exclude`` argument can contain a list of field names that should
-be omitted when validating. This method raises ``ValidationError`` containing a
-message dict with errors from all fields.
+The optional ``exclude`` argument can contain a list of field names to omit
+when validating. This method raises ``ValidationError`` containing a
+message dictionary with errors from all fields.
To add your own validation logic, override the supplied ``validate()`` method:
Note that ``full_validate`` will NOT be called automatically when you call
-your model's ``save()`` method. You will need to call it manually if you wish
-to run your model validators. This is for the purposes of backwards
-compatibility. However, if you are using a ``ModelForm``, it will call
-``full_validate`` for you, and present any errors along with the other form
-error messages.
+your model's ``save()`` method. You'll need to call it manually if you want
+to run your model validators. (This is for backwards compatibility.) However,
+if you're using a ``ModelForm``, it will call ``full_validate`` for you and
+will present any errors along with the other form error messages.
.. method:: Model.validate()
The ``validate()`` method on ``Model`` by default checks for uniqueness of
-fields and group of fields that are declared to be unique so, remember to call
-``self.validate_unique()`` or the superclasses ``validate`` method if you want
+fields and group of fields that are declared to be unique, so remember to call
+``self.validate_unique()`` or the superclass' ``validate`` method if you want
this validation to run.
-Any ``ValidationError`` raised in this method will be propagated in the
+Any ``ValidationError`` raised in this method will be included in the
``message_dict`` under ``NON_FIELD_ERRORS``.
Saving objects