From 05d074670a069465d2e4fad2ff1e716f59a61bed Mon Sep 17 00:00:00 2001
From: Adrian Holovaty <adrian@holovaty.com>
Date: Fri, 5 Aug 2005 14:33:29 +0000
Subject: [PATCH] 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
---
 docs/db-api.txt | 8 ++++++++
 1 file changed, 8 insertions(+)

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
 ========