diff --git a/doc/src/sgml/xfunc.sgml b/doc/src/sgml/xfunc.sgml index 529bdec3ef..e3c36d0397 100644 --- a/doc/src/sgml/xfunc.sgml +++ b/doc/src/sgml/xfunc.sgml @@ -1,5 +1,5 @@ @@ -72,10 +72,13 @@ $Header: /cvsroot/pgsql/doc/src/sgml/xfunc.sgml,v 1.40 2001/10/26 21:17:03 tgl E SQL functions execute an arbitrary list of SQL statements, returning - the results of the last query in the list. In the simple (non-set) + the result of the last query in the list, which must be a + SELECT. + In the simple (non-set) case, the first row of the last query's result will be returned. - (Bear in mind that the first row is not well-defined - unless you use ORDER BY.) If the last query happens + (Bear in mind that the first row of a multi-row + result is not well-defined unless you use ORDER BY.) + If the last query happens to return no rows at all, NULL will be returned. @@ -441,7 +444,8 @@ SELECT name, listchildren(name) FROM nodes; (5 rows) - Notice that no output row appears for Child2, Child3, etc. + In the last SELECT, + notice that no output row appears for Child2, Child3, etc. This happens because listchildren() returns an empty set for those inputs, so no output rows are generated.