diff --git a/doc/src/sgml/ref/select.sgml b/doc/src/sgml/ref/select.sgml index cc8cd48583a59f7a3e15ba7ae799dcc3b003b30f..39fc6b6d830b34c4f6c2249127337ee59744b1fa 100644 --- a/doc/src/sgml/ref/select.sgml +++ b/doc/src/sgml/ref/select.sgml @@ -1064,7 +1064,8 @@ SELECT name FROM distributors ORDER BY code; <synopsis> LIMIT { <replaceable class="parameter">count</replaceable> | ALL } OFFSET <replaceable class="parameter">start</replaceable> -</synopsis><replaceable class="parameter">count</replaceable> specifies the +</synopsis> + <replaceable class="parameter">count</replaceable> specifies the maximum number of rows to return, while <replaceable class="parameter">start</replaceable> specifies the number of rows to skip before starting to return rows. When both are specified, @@ -1087,17 +1088,19 @@ OFFSET <replaceable class="parameter">start</replaceable> OFFSET <replaceable class="parameter">start</replaceable> { ROW | ROWS } FETCH { FIRST | NEXT } [ <replaceable class="parameter">count</replaceable> ] { ROW | ROWS } ONLY </synopsis> - According to the standard, the <literal>OFFSET</literal> clause must come - before the <literal>FETCH</literal> clause if both are present; but - <productname>PostgreSQL</> is laxer and allows either order. + In this syntax, to write anything except a simple integer constant for + <replaceable class="parameter">start</> or <replaceable + class="parameter">count</replaceable>, you must write parentheses + around it. + If <replaceable class="parameter">count</> is + omitted in a <literal>FETCH</> clause, it defaults to 1. <literal>ROW</literal> and <literal>ROWS</literal> as well as <literal>FIRST</literal> and <literal>NEXT</literal> are noise words that don't influence - the effects of these clauses. In this syntax, when using expressions - other than simple constants for <replaceable class="parameter">start</> - or <replaceable class="parameter">count</replaceable>, parentheses will be - necessary in most cases. If <replaceable class="parameter">count</> is - omitted in <literal>FETCH</>, it defaults to 1. + the effects of these clauses. + According to the standard, the <literal>OFFSET</literal> clause must come + before the <literal>FETCH</literal> clause if both are present; but + <productname>PostgreSQL</> is laxer and allows either order. </para> <para>