Fix missing parentheses for current_query(), per bug #5378.

Also make a couple other minor editorial improvements.
This commit is contained in:
Tom Lane 2010-03-18 15:29:44 +00:00
parent 12c2f2f66c
commit 5f6285616d

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.509 2010/03/16 16:03:24 sriggs Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.510 2010/03/18 15:29:44 tgl Exp $ -->
<chapter id="functions"> <chapter id="functions">
<title>Functions and Operators</title> <title>Functions and Operators</title>
@ -11512,7 +11512,7 @@ postgres=# select * from unnest2(array[[1,2],[3,4]]);
<row> <row>
<entry><literal><function>current_schemas</function>(<type>boolean</type>)</literal></entry> <entry><literal><function>current_schemas</function>(<type>boolean</type>)</literal></entry>
<entry><type>name[]</type></entry> <entry><type>name[]</type></entry>
<entry>names of schemas in search path optionally including implicit schemas</entry> <entry>names of schemas in search path, optionally including implicit schemas</entry>
</row> </row>
<row> <row>
@ -11522,11 +11522,11 @@ postgres=# select * from unnest2(array[[1,2],[3,4]]);
</row> </row>
<row> <row>
<entry><literal><function>current_query</function></literal></entry> <entry><literal><function>current_query</function>()</literal></entry>
<entry><type>text</type></entry> <entry><type>text</type></entry>
<entry>text of the currently executing query, as submitted <entry>text of the currently executing query, as submitted
by the client (might contain more than one statement)</entry> by the client (might contain more than one statement)</entry>
</row> </row>
<row> <row>
<!-- See also the entry for this in monitoring.sgml --> <!-- See also the entry for this in monitoring.sgml -->
@ -11612,6 +11612,17 @@ postgres=# select * from unnest2(array[[1,2],[3,4]]);
</tgroup> </tgroup>
</table> </table>
<note>
<para>
<function>current_catalog</function>, <function>current_schema</function>,
<function>current_user</function>, <function>session_user</function>,
and <function>user</function> have special syntactic status
in <acronym>SQL</acronym>: they must be called without trailing
parentheses. (In PostgreSQL, parentheses can optionally be used with
<function>current_schema</function>, but not with the others.)
</para>
</note>
<indexterm> <indexterm>
<primary>user</primary> <primary>user</primary>
<secondary>current</secondary> <secondary>current</secondary>
@ -11657,17 +11668,6 @@ postgres=# select * from unnest2(array[[1,2],[3,4]]);
the current user is the <quote>effective user</quote>. the current user is the <quote>effective user</quote>.
</para> </para>
<note>
<para>
<function>current_catalog</function>, <function>current_schema</function>,
<function>current_user</function>, <function>session_user</function>,
and <function>user</function> have special syntactic status
in <acronym>SQL</acronym>: they must be called without trailing
parentheses (optional in PostgreSQL in the case
of <function>current_schema</function>).
</para>
</note>
<para> <para>
<function>current_schema</function> returns the name of the schema that is <function>current_schema</function> returns the name of the schema that is
first in the search path (or a null value if the search path is first in the search path (or a null value if the search path is