doc: Fix commas and improve spacing

This commit is contained in:
Peter Eisentraut 2015-11-16 18:59:55 -05:00
parent 34d4f49bb9
commit 75c8af902e

View File

@ -1253,8 +1253,8 @@ ROLLUP ( <replaceable>e1</>, <replaceable>e2</>, <replaceable>e3</>, ... )
GROUPING SETS ( GROUPING SETS (
( <replaceable>e1</>, <replaceable>e2</>, <replaceable>e3</>, ... ), ( <replaceable>e1</>, <replaceable>e2</>, <replaceable>e3</>, ... ),
... ...
( <replaceable>e1</>, <replaceable>e2</> ) ( <replaceable>e1</>, <replaceable>e2</> ),
( <replaceable>e1</> ) ( <replaceable>e1</> ),
( ) ( )
) )
</programlisting> </programlisting>
@ -1282,7 +1282,7 @@ GROUPING SETS (
( b, c ), ( b, c ),
( b ), ( b ),
( c ), ( c ),
( ), ( )
) )
</programlisting> </programlisting>
</para> </para>
@ -1294,27 +1294,27 @@ GROUPING SETS (
units for the purposes of generating the individual grouping sets. units for the purposes of generating the individual grouping sets.
For example: For example:
<programlisting> <programlisting>
CUBE ( (a,b), (c,d) ) CUBE ( (a, b), (c, d) )
</programlisting> </programlisting>
is equivalent to is equivalent to
<programlisting> <programlisting>
GROUPING SETS ( GROUPING SETS (
( a, b, c, d ) ( a, b, c, d ),
( a, b ) ( a, b ),
( c, d ) ( c, d ),
( ) ( )
) )
</programlisting> </programlisting>
and and
<programlisting> <programlisting>
ROLLUP ( a, (b,c), d ) ROLLUP ( a, (b, c), d )
</programlisting> </programlisting>
is equivalent to is equivalent to
<programlisting> <programlisting>
GROUPING SETS ( GROUPING SETS (
( a, b, c, d ) ( a, b, c, d ),
( a, b, c ) ( a, b, c ),
( a ) ( a ),
( ) ( )
) )
</programlisting> </programlisting>
@ -1333,27 +1333,27 @@ GROUPING SETS (
clause, then the final list of grouping sets is the cross product of the clause, then the final list of grouping sets is the cross product of the
individual items. For example: individual items. For example:
<programlisting> <programlisting>
GROUP BY a, CUBE(b,c), GROUPING SETS ((d), (e)) GROUP BY a, CUBE (b, c), GROUPING SETS ((d), (e))
</programlisting> </programlisting>
is equivalent to is equivalent to
<programlisting> <programlisting>
GROUP BY GROUPING SETS ( GROUP BY GROUPING SETS (
(a,b,c,d), (a,b,c,e), (a, b, c, d), (a, b, c, e),
(a,b,d), (a,b,e), (a, b, d), (a, b, e),
(a,c,d), (a,c,e), (a, c, d), (a, c, e),
(a,d), (a,e) (a, d), (a, e)
) )
</programlisting> </programlisting>
</para> </para>
<note> <note>
<para> <para>
The construct <literal>(a,b)</> is normally recognized in expressions as The construct <literal>(a, b)</> is normally recognized in expressions as
a <link linkend="sql-syntax-row-constructors">row constructor</link>. a <link linkend="sql-syntax-row-constructors">row constructor</link>.
Within the <literal>GROUP BY</> clause, this does not apply at the top Within the <literal>GROUP BY</> clause, this does not apply at the top
levels of expressions, and <literal>(a,b)</> is parsed as a list of levels of expressions, and <literal>(a, b)</> is parsed as a list of
expressions as described above. If for some reason you <emphasis>need</> expressions as described above. If for some reason you <emphasis>need</>
a row constructor in a grouping expression, use <literal>ROW(a,b)</>. a row constructor in a grouping expression, use <literal>ROW(a, b)</>.
</para> </para>
</note> </note>
</sect2> </sect2>