Marginal editorial improvements for array_agg patch documentation.
authorTom Lane
Thu, 13 Nov 2008 23:01:09 +0000 (23:01 +0000)
committerTom Lane
Thu, 13 Nov 2008 23:01:09 +0000 (23:01 +0000)
doc/src/sgml/func.sgml

index 20443f2b288294bfa6b44f068308236114b7cc6e..aee74366b01f0b2ed5640f29598bb10b2608a2a6 100644 (file)
@@ -1,4 +1,4 @@
-
+
 
  
   Functions and Operators
@@ -8387,8 +8387,8 @@ SELECT xmlagg(x) FROM test;
     
 
     
-     The influence the order of the concatenation, something like the
-     following approach to sort the input values can be used:
+     To determine the order of the concatenation, something like the
+     following approach can be used:
 
 
 SELECT xmlagg(x) FROM (SELECT * FROM test ORDER BY y DESC) AS tab;
@@ -9772,19 +9772,19 @@ SELECT count(*) FROM sometable;
    and xmlagg, as well as similar user-defined
    aggregate functions, produce meaningfully different result values
    depending on the order of the input values.  In the current
-   implementation, the order of the concatenation is in principle
-   undefined.  Making the input values to be sorted in some other way
+   implementation, the order of the input is in principle unspecified.
+   Supplying the input values from a sorted subquery
    will usually work, however.  For example:
 
 
-SELECT xmlagg(x) FROM (SELECT * FROM test ORDER BY y DESC) AS tab;
+SELECT xmlagg(x) FROM (SELECT x FROM test ORDER BY y DESC) AS tab;
 ]]>
 
-   But this approach is not guaranteed to work in all situations, and
-   it is not strictly SQL-conforming.  A future version of PostgreSQL
-   might provide an additional feature to control the order in a
-   better-defined way (xmlagg(expr ORDER BY expr, expr,
-   ...).
+   But this syntax is not allowed in the SQL standard, and is
+   not portable to other database systems.  A future version of
+   PostgreSQL might provide an additional feature to control
+   the order in a better-defined way (xmlagg(expr ORDER BY expr, expr,
+   ...)).