Ticket #5843: newforms_form_clean.diff

docs/newforms.txt

@@ -1557 +1557 @@
 ``_errors`` dictionary attribute on the form as well. In this way, you will
 already know which fields have passed their individual validation requirements.
 
-A simple example
-~~~~~~~~~~~~~~~~
+A simple example: Field.clean()
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Here's a simple example of a custom field that validates its input is a string
 containing comma-separated e-mail addresses, with at least one address. We'll
@@ -1587 +1587 @@
         senders = MultiEmailField()
         cc_myself = forms.BooleanField(required=False)
 
+A simple example: Form.clean()
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You want to validate, that both passwords are equal. The error is a non
+field error (see above)::
+
+    class UserRegistration(Form):
+       username = CharField(max_length=10)
+       password1 = CharField(widget=PasswordInput)
+       password2 = CharField(widget=PasswordInput)
+       def clean(self):
+           if self.cleaned_data.get('password1') and self.cleaned_data.get('password2') and self.cleaned_data['password1'] != self.cleaned_data['password2']:
+               raise ValidationError(u'Please make sure your passwords match.')
+           return self.cleaned_data
+
+
 Widgets
 =======