Added 'How this is possible' section to docs/db-api.txt, describing keyword arguments in the API

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

1 files changed, 8 insertions, 0 deletions

diff --git a/docs/db-api.txt b/docs/db-api.txt
index 8a85c4ebdd..ce9667477f 100644
--- a/docs/db-api.txt
+++ b/docs/db-api.txt
@@ -47,6 +47,12 @@ translates (roughly) into the following SQL:
 
     SELECT * FROM polls_polls WHERE pub_date < NOW();
 
+.. admonition:: How this is possible
+
+   Python has the ability to define functions that accept arbitrary name-value
+   arguments whose names and values are evaluated at run time. For more
+   information, see `Keyword Arguments`_ in the official Python tutorial.
+
 The DB API supports the following lookup types:
 
     ===========  ==============================================================
@@ -113,6 +119,8 @@ statements are equivalent::
     choices.get_list(poll__id__exact=3)
     choices.get_list(poll__pk=3)
 
+.. _`Keyword Arguments`: http://docs.python.org/tut/node6.html#SECTION006720000000000000000
+
 Ordering
 ========