more explicit doc

diff --git a/lib/sqlalchemy/orm/query.py b/lib/sqlalchemy/orm/query.py
index 6d4ae34096ae19d9a37b11c4bdfebfdab0915052..01562f7b510b7e51f5fc8bbc82019f3433ef32f5 100644 (file)
--- a/lib/sqlalchemy/orm/query.py
+++ b/lib/sqlalchemy/orm/query.py
@@ -592,7 +592,7 @@ class Query(object):
         return q
         
     def first(self):
-        """Return the first result of this ``Query``.
+        """Return the first result of this ``Query`` or None if the result doesn't contain any row.
 
         This results in an execution of the underlying query.
         """