diff --git a/docs/topics/forms/formsets.txt b/docs/topics/forms/formsets.txt index 61c2ad377a..c72b0f3c63 100644 --- a/docs/topics/forms/formsets.txt +++ b/docs/topics/forms/formsets.txt @@ -110,6 +110,8 @@ attempt to provide an article, but fail to do so:: As we can see the formset properly performed validation and gave us the expected errors. +.. _understanding-the-managementform: + Understanding the ManagementForm ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/topics/forms/modelforms.txt b/docs/topics/forms/modelforms.txt index 0166d4d08a..9a46ffd70c 100644 --- a/docs/topics/forms/modelforms.txt +++ b/docs/topics/forms/modelforms.txt @@ -197,7 +197,8 @@ accepts either ``True`` or ``False``. If you call ``save()`` with the database. In this case, it's up to you to call ``save()`` on the resulting model instance. This is useful if you want to do custom processing on the object before saving it, or if you want to use one of the specialized -:ref:`model saving options `. ``commit`` is ``True`` by default. +:ref:`model saving options `. ``commit`` is ``True`` +by default. Another side effect of using ``commit=False`` is seen when your model has a many-to-many relation with another model. If your model has a many-to-many @@ -272,7 +273,7 @@ specify ``fields`` or ``exclude`` like this:: class Meta: model = Author fields = ('name', 'title') - + class PartialAuthorForm(ModelForm): class Meta: model = Author @@ -429,7 +430,7 @@ Alternatively, you can create a subclass that implements a ``get_queryset()`` method:: from django.forms.models import BaseModelFormSet - + class BaseAuthorFormSet(BaseModelFormSet): def get_queryset(self): return super(BaseAuthorFormSet, self).get_queryset().filter(name__startswith='O') @@ -496,7 +497,7 @@ number of objects needed:: >>> Author.objects.order_by('name') [, , ] - + >>> AuthorFormSet = modelformset_factory(Author, max_num=2, extra=1) >>> formset = AuthorFormSet(queryset=Author.objects.order_by('name')) >>> formset.initial @@ -583,7 +584,8 @@ itself:: When you manually render the forms yourself, be sure to render the management -form as shown above. See the :ref:`management form documentation `. +form as shown above. See the :ref:`management form documentation +`. Third, you can manually render each field::