From ecfd958c84a2b224ff1b71c42cfe481da98c14e6 Mon Sep 17 00:00:00 2001
From: Tianyi Wang <wty52133@gmail.com>
Date: Tue, 15 Oct 2013 11:55:43 +0100
Subject: [PATCH] [1.6.x] Fixed #21006 -- Added example code for overriding
 methods on an InlineFormSet.

Thanks treysta at gmail.com for the suggestion.

Backport of 9bfe66164e from master
---
 docs/topics/forms/modelforms.txt | 30 ++++++++++++++++++++++++++----
 1 file changed, 26 insertions(+), 4 deletions(-)

diff --git a/docs/topics/forms/modelforms.txt b/docs/topics/forms/modelforms.txt
index 585a31831b..c88d90921c 100644
--- a/docs/topics/forms/modelforms.txt
+++ b/docs/topics/forms/modelforms.txt
@@ -919,7 +919,7 @@ class's ``clean`` method::
             # example custom validation across forms in the formset:
             for form in self.forms:
                 # your custom formset validation
-                pass
+                ...
 
 Using a custom queryset
 -----------------------
@@ -1046,13 +1046,35 @@ a particular author, you could do this::
 
     :ref:`Manually rendered can_delete and can_order <manually-rendered-can-delete-and-can-order>`.
 
-Overriding ``clean()`` on an ``InlineFormSet``
-----------------------------------------------
+Overriding methods on an ``InlineFormSet``
+------------------------------------------
 
-See :ref:`model-formsets-overriding-clean`, but subclass
+When overriding methods on ``InlineFormSet``, you should subclass
 :class:`~models.BaseInlineFormSet` rather than
 :class:`~models.BaseModelFormSet`.
 
+For example, If you want to override ``clean()``::
+
+    from django.forms.models import BaseInlineFormSet
+
+    class MyModelFormSet(BaseInlineFormSet):
+        def clean(self):
+            super(MyModelFormSet, self).clean()
+            # example custom validation across forms in the formset:
+            for form in self.forms:
+                # your custom formset validation
+                ...
+
+See also :ref:`model-formsets-overriding-clean`.
+
+Then when you create your inline formset, pass in the optional argument
+``formset``::
+
+    >>> from django.forms.models import inlineformset_factory
+    >>> BookFormSet = inlineformset_factory(Author, Book, formset=MyModelFormSet)
+    >>> author = Author.objects.get(name=u'Mike Royko')
+    >>> formset = BookFormSet(instance=author)
+
 More than one foreign key to the same model
 -------------------------------------------