docs: improve CREATE FUNCTION docs about language case and quoting

Report from Marc Mamin

diff --git a/doc/src/sgml/ref/create_function.sgml b/doc/src/sgml/ref/create_function.sgml
index 81278bb2f813fc614c68033e1bd03b7c9339e8c1..b61b9785ee9f7039519063a690964db23a4465ea 100644 (file)
--- a/doc/src/sgml/ref/create_function.sgml
+++ b/doc/src/sgml/ref/create_function.sgml
@@ -252,10 +252,10 @@ CREATE [ OR REPLACE ] FUNCTION
      
       
        The name of the language that the function is implemented in.
-       Can be SQL, C,
+       It can be sql, c,
        internal, or the name of a user-defined
-       procedural language.  For backward compatibility,
-       the name can be enclosed by single quotes.
+       procedural language, e.g. plpgsql.  Enclosing the
+       name in single quotes is deprecated and requires matching case.