From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Wed, 11 Nov 2009 03:45:55 +0000 (+0000)
Subject: document NOT IN, IN with query as subq
X-Git-Tag: rel_0_5_7~22
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f48efe8948da795a0e4a9ef630696e5ce4c97c1e;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

document NOT IN, IN with query as subq
---

diff --git a/doc/build/ormtutorial.rst b/doc/build/ormtutorial.rst
index c10d457f14..e1d833cb82 100644
--- a/doc/build/ormtutorial.rst
+++ b/doc/build/ormtutorial.rst
@@ -447,10 +447,22 @@ Here's a rundown of some of the most common operators used in ``filter()``:
 
     query.filter(User.name.in_(['ed', 'wendy', 'jack']))
 
+    # works with query objects too:
+    
+    query.filter(User.name.in_(session.query(User.name).filter(User.name.like('%ed%'))))
+    
+* NOT IN::
+
+    query.filter(~User.name.in_(['ed', 'wendy', 'jack']))
+
 * IS NULL::
 
     filter(User.name == None)
 
+* IS NOT NULL::
+
+    filter(User.name != None)
+
 * AND::
 
     from sqlalchemy import and_