Docs for Model.clean() are misleading

[anonymous]

from ​https://docs.djangoproject.com/en/1.6/ref/models/instances/#django.db.models.Model.clean

---

Model.clean()

This method should be used to provide custom model validation, and to modify attributes on your model if desired. For instance, you could use it to automatically provide a value for a field, or to do validation that requires access to more than a single field...

---

This is misleading, as it seems to say that Model.clean() is called when saving an object. It should be made clear here that clean() is for validation in forms.

Here's someone else who has run into this misunderstanding: ​http://stackoverflow.com/questions/18803112/django-doesnt-call-model-clean-method

[Tim Graham <timograham@…>]

In b43bbd6d399c9ecca09c2e181715c8856ef5a598:

Fixed #22473 -- Emphasized that Model.clean() is not called from Model.save().

[Tim Graham <timograham@…>]

In 839deb7a77a2321309da944031b7316322a0afbb:

[1.6.x] Fixed #22473 -- Emphasized that Model.clean() is not called from Model.save().

Backport of b43bbd6d39 from master

[Tim Graham <timograham@…>]

In a9ad0818996f2c307f505dca68008841be06e0fc:

[1.7.x] Fixed #22473 -- Emphasized that Model.clean() is not called from Model.save().

Backport of b43bbd6d39 from master