Commit fda21aa0 authored by Tom Lane's avatar Tom Lane

Docs: clarify description of LIMIT/OFFSET behavior.

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.
parent 22989a8e
...@@ -1794,16 +1794,19 @@ SELECT <replaceable>select_list</replaceable> ...@@ -1794,16 +1794,19 @@ SELECT <replaceable>select_list</replaceable>
<para> <para>
If a limit count is given, no more than that many rows will be 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</> <literal>LIMIT ALL</> is the same as omitting the <literal>LIMIT</>
clause. clause, as is <literal>LIMIT</> with a NULL argument.
</para> </para>
<para> <para>
<literal>OFFSET</> says to skip that many rows before beginning to <literal>OFFSET</> says to skip that many rows before beginning to
return rows. <literal>OFFSET 0</> is the same as omitting the return rows. <literal>OFFSET 0</> is the same as omitting the
<literal>OFFSET</> clause, and <literal>LIMIT NULL</> is the same <literal>OFFSET</> clause, as is <literal>OFFSET</> with a NULL argument.
as omitting the <literal>LIMIT</> clause. If both <literal>OFFSET</> </para>
<para>
If both <literal>OFFSET</>
and <literal>LIMIT</> appear, then <literal>OFFSET</> rows are and <literal>LIMIT</> appear, then <literal>OFFSET</> rows are
skipped before starting to count the <literal>LIMIT</> rows that skipped before starting to count the <literal>LIMIT</> rows that
are returned. are returned.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment