From eb4f16e666ae3d7c29b5bcae737ce755d5003a26 Mon Sep 17 00:00:00 2001
From: Adrian Holovaty <adrian@holovaty.com>
Date: Mon, 10 Oct 2005 20:18:56 +0000
Subject: [PATCH] Improved docs/db-api.txt to say add_FOO() methods always
 return the newly-created object.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@825 bcc190cf-cafb-0310-a4f2-bffc1f526a37
---
 docs/db-api.txt | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/db-api.txt b/docs/db-api.txt
index 8a02437aaa9..b80d4e86475 100644
--- a/docs/db-api.txt
+++ b/docs/db-api.txt
@@ -449,8 +449,7 @@ Related objects (e.g. ``Choices``) are created using convenience functions::
     >>> p.get_choice_count()
     4
 
-Each of those ``add_choice`` methods is equivalent to (except obviously much
-simpler than)::
+Each of those ``add_choice`` methods is equivalent to (but much simpler than)::
 
     >>> c = polls.Choice(poll_id=p.id, choice="Over easy", votes=0)
     >>> c.save()
@@ -459,6 +458,8 @@ Note that when using the `add_foo()`` methods, you do not give any value
 for the ``id`` field, nor do you give a value for the field that stores
 the relation (``poll_id`` in this case).
 
+The ``add_FOO()`` method always returns the newly created object.
+
 Deleting objects
 ================