Docs: clarify description of LIMIT/OFFSET behavior.

tglsfdc · tglsfdc · commit fda21aa05bdc · 2016-04-14T10:57:29.000-04:00
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.
diff --git a/doc/src/sgml/queries.sgml b/doc/src/sgml/queries.sgml
@@ -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.
