summaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorTom Lane <tgl@sss.pgh.pa.us>2015-12-28 11:04:42 -0500
committerTom Lane <tgl@sss.pgh.pa.us>2015-12-28 11:04:42 -0500
commitaba82401dd04387bf17968b839039fe7cbec8f4e (patch)
treefbcf38133c27dd45792ca75aa992621c54b56e63 /doc/src
parentf98bc20dd125bd356864d76e8b32fab2b2df51df (diff)
Update documentation about pseudo-types.
Tone down an overly strong statement about which pseudo-types PLs are likely to allow. Add "event_trigger" to the list, as well as "pg_ddl_command" in 9.5/HEAD. Back-patch to 9.3 where event_trigger was added.
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/datatype.sgml18
1 files changed, 14 insertions, 4 deletions
diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index 87f424e076f..2b043b0d638 100644
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -4562,6 +4562,10 @@ SELECT * FROM pg_attribute
</indexterm>
<indexterm zone="datatype-pseudo">
+ <primary>event_trigger</primary>
+ </indexterm>
+
+ <indexterm zone="datatype-pseudo">
<primary>language_handler</primary>
</indexterm>
@@ -4665,7 +4669,7 @@ SELECT * FROM pg_attribute
<row>
<entry><type>record</></entry>
- <entry>Identifies a function returning an unspecified row type.</entry>
+ <entry>Identifies a function taking or returning an unspecified row type.</entry>
</row>
<row>
@@ -4674,6 +4678,11 @@ SELECT * FROM pg_attribute
</row>
<row>
+ <entry><type>event_trigger</></entry>
+ <entry>An event trigger function is declared to return <type>event_trigger.</></entry>
+ </row>
+
+ <row>
<entry><type>void</></entry>
<entry>Indicates that a function returns no value.</entry>
</row>
@@ -4695,10 +4704,11 @@ SELECT * FROM pg_attribute
<para>
Functions coded in procedural languages can use pseudo-types only as
- allowed by their implementation languages. At present the procedural
- languages all forbid use of a pseudo-type as argument type, and allow
+ allowed by their implementation languages. At present most procedural
+ languages forbid use of a pseudo-type as an argument type, and allow
only <type>void</> and <type>record</> as a result type (plus
- <type>trigger</> when the function is used as a trigger). Some also
+ <type>trigger</> or <type>event_trigger</> when the function is used
+ as a trigger or event trigger). Some also
support polymorphic functions using the types <type>anyelement</>,
<type>anyarray</>, <type>anynonarray</>, <type>anyenum</>, and
<type>anyrange</>.