Clarify CREATE FUNCTION documentation about handling of typmods.
authorTom Lane
Wed, 13 Nov 2013 18:26:33 +0000 (13:26 -0500)
committerTom Lane
Wed, 13 Nov 2013 18:26:44 +0000 (13:26 -0500)
The previous text was a bit misleading, as well as unnecessarily vague
about what information would be discarded.  Per gripe from Craig Skinner.

doc/src/sgml/ref/create_function.sgml

index f42bd48966035d8b5b0fcec76a67795c70c41f31..c82fbdca7a1bc0f5bc4058994f172e7aa2424c8d 100644 (file)
@@ -579,12 +579,13 @@ CREATE FUNCTION foo(int, int default 42) ...
 
    
     The full SQL type syntax is allowed for
-    input arguments and return value. However, some details of the
-    type specification (e.g., the precision field for
-    type numeric) are the responsibility of the
-    underlying function implementation and are silently swallowed
-    (i.e., not recognized or
-    enforced) by the CREATE FUNCTION command.
+    declaring a function's arguments and return value.  However,
+    parenthesized type modifiers (e.g., the precision field for
+    type numeric) are discarded by CREATE FUNCTION.
+    Thus for example
+    CREATE FUNCTION foo (varchar(10)) ...
+    is exactly the same as
+    CREATE FUNCTION foo (varchar) ....