Docs: clarify description of LIMIT/OFFSET behavior.
authorTom Lane <tgl@sss.pgh.pa.us>
Thu, 14 Apr 2016 14:57:29 +0000 (10:57 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Thu, 14 Apr 2016 14:57:29 +0000 (10:57 -0400)
Section 7.6 was a tad confusing because it specified what LIMIT NULL
does, but neglected to do the same for OFFSET NULL, making this look
like perhaps a special case or a wrong restatement of the bit about
LIMIT ALL.  Wordsmith a bit while at it.  Per bug #14084.

doc/src/sgml/queries.sgml

index b37adaa9ee6e53e7f34d17b788449d9db9d90c1c..718262f1aa7126a6ab3d67a4a0b9d702c17c2ac7 100644 (file)
@@ -1794,16 +1794,19 @@ SELECT <replaceable>select_list</replaceable>
 
   <para>
    If a limit count is given, no more than that many rows will be
-   returned (but possibly less, if the query itself yields less rows).
+   returned (but possibly fewer, if the query itself yields fewer rows).
    <literal>LIMIT ALL</> is the same as omitting the <literal>LIMIT</>
-   clause.
+   clause, as is <literal>LIMIT</> with a NULL argument.
   </para>
 
   <para>
    <literal>OFFSET</> says to skip that many rows before beginning to
    return rows.  <literal>OFFSET 0</> is the same as omitting the
-   <literal>OFFSET</> clause, and <literal>LIMIT NULL</> is the same
-   as omitting the <literal>LIMIT</> clause.  If both <literal>OFFSET</>
+   <literal>OFFSET</> clause, as is <literal>OFFSET</> with a NULL argument.
+  </para>
+
+  <para>
+   If both <literal>OFFSET</>
    and <literal>LIMIT</> appear, then <literal>OFFSET</> rows are
    skipped before starting to count the <literal>LIMIT</> rows that
    are returned.