浏览代码

Fixed #30917 -- Clarified formsets topic documentation.

Ken Whitesell 5 年之前
父节点
当前提交
4c762588ff
共有 1 个文件被更改,包括 5 次插入5 次删除
  1. 5 5
      docs/topics/forms/formsets.txt

+ 5 - 5
docs/topics/forms/formsets.txt

@@ -21,9 +21,9 @@ a formset out of an ``ArticleForm`` you would do::
     >>> from django.forms import formset_factory
     >>> from django.forms import formset_factory
     >>> ArticleFormSet = formset_factory(ArticleForm)
     >>> ArticleFormSet = formset_factory(ArticleForm)
 
 
-You now have created a formset named ``ArticleFormSet``. The formset gives you
-the ability to iterate over the forms in the formset and display them as you
-would with a regular form::
+You now have created a formset class named ``ArticleFormSet``.
+Instantiating the formset gives you the ability to iterate over the forms 
+in the formset and display them as you would with a regular form::
 
 
     >>> formset = ArticleFormSet()
     >>> formset = ArticleFormSet()
     >>> for form in formset:
     >>> for form in formset:
@@ -34,11 +34,11 @@ would with a regular form::
 As you can see it only displayed one empty form. The number of empty forms
 As you can see it only displayed one empty form. The number of empty forms
 that is displayed is controlled by the ``extra`` parameter. By default,
 that is displayed is controlled by the ``extra`` parameter. By default,
 :func:`~django.forms.formsets.formset_factory` defines one extra form; the
 :func:`~django.forms.formsets.formset_factory` defines one extra form; the
-following example will display two blank forms::
+following example will create a formset class to display two blank forms::
 
 
     >>> ArticleFormSet = formset_factory(ArticleForm, extra=2)
     >>> ArticleFormSet = formset_factory(ArticleForm, extra=2)
 
 
-Iterating over the ``formset`` will render the forms in the order they were
+Iterating over a formset will render the forms in the order they were
 created. You can change this order by providing an alternate implementation for
 created. You can change this order by providing an alternate implementation for
 the ``__iter__()`` method.
 the ``__iter__()`` method.