Added a bit to 'Saving ManyToMany Fields' explicitly explaining how to add multiple relations in one statement

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16689 bcc190cf-cafb-0310-a4f2-bffc1f526a37

1 files changed, 9 insertions, 0 deletions

diff --git a/docs/topics/db/queries.txt b/docs/topics/db/queries.txt
index a4267489b9..8e2c0cc021 100644
--- a/docs/topics/db/queries.txt
+++ b/docs/topics/db/queries.txt
@@ -113,6 +113,15 @@ method on the field to add a record to the relation. This example adds the
     >>> joe = Author.objects.create(name="Joe")
     >>> entry.authors.add(joe)
 
+To add multiple records to a ``ManyToManyField`` in one go, include multiple
+arguments in the call to ``add()``, like this::
+
+    >>> john = Author.objects.create(name="John")
+    >>> paul = Author.objects.create(name="Paul")
+    >>> george = Author.objects.create(name="George")
+    >>> ringo = Author.objects.create(name="Ringo")
+    >>> entry.authors.add(john, paul, george, ringo)
+
 Django will complain if you try to assign or add an object of the wrong type.
 
 Retrieving objects