Merge pull request #674 from minusf/num_queries_doc

minor fixes in django helpers

Author: blueyed

docs/helpers.rst

@@ -283,17 +283,20 @@ Example
 ``django_assert_num_queries``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. py:function:: django_assert_num_queries(connection=None, info=None)
+.. py:function:: django_assert_num_queries(num, connection=None, info=None)
 
+  :param num: expected number of queries
   :param connection: optional non-default DB connection
   :param str info: optional info message to display on failure
 
 This fixture allows to check for an expected number of DB queries.
 
+If the assertion failed, the executed queries can be shown by using
+the verbose command line option.
+
 It wraps `django.test.utils.CaptureQueriesContext` and yields the wrapped
 CaptureQueriesContext instance.
 
-
 Example usage::
 
     def test_queries(django_assert_num_queries):
@@ -310,8 +313,9 @@ Example usage::
 ``django_assert_max_num_queries``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. py:function:: django_assert_num_queries(connection=None, info=None)
+.. py:function:: django_assert_max_num_queries(num, connection=None, info=None)
 
+  :param num: expected maximum number of queries
   :param connection: optional non-default DB connection
   :param str info: optional info message to display on failure
 
@@ -322,7 +326,7 @@ It is a specialized version of :fixture:`django_assert_num_queries`.
 Example usage::
 
     def test_max_queries(django_assert_max_num_queries):
-        with django_assert_max_num_queries(3):
+        with django_assert_max_num_queries(2):
             Item.objects.create('foo')
             Item.objects.create('bar')