Add note on the use of tuple_() for the IN operator

diff --git a/doc/build/orm/tutorial.rst b/doc/build/orm/tutorial.rst
index 14ea82a0ddd2bb5e82429bc5e65b0d0b46b8b979..3e3ac0cd4a13b1f1d9636e900b0d08490da048c0 100644 (file)
--- a/doc/build/orm/tutorial.rst
+++ b/doc/build/orm/tutorial.rst
@@ -783,6 +783,9 @@ Here's a rundown of some of the most common operators used in
         session.query(User.name).filter(User.name.like('%ed%'))
     ))
 
+ .. note:: for composite (multi-column) IN queries, group columns together
+    using :func:`.tuple_`
+
 * :meth:`NOT IN <.ColumnOperators.notin_>`::
 
     query.filter(~User.name.in_(['ed', 'wendy', 'jack']))