diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml index 5f7a8322f76..8c3ca324a4c 100644 --- a/doc/src/sgml/func.sgml +++ b/doc/src/sgml/func.sgml @@ -1,4 +1,4 @@ - + Functions and Operators @@ -9882,12 +9882,18 @@ SELECT pg_type_is_visible('myschema.widget'::regtype); - pg_get_serial_sequence fetches the name of the - sequence associated with a column, or NULL if there is no sequence - associated with the column. The result is suitably formatted for passing - to the sequence functions (see ). - This association can be modified or removed with ALTER SEQUENCE - OWNED BY. (The function probably should have been called + pg_get_serial_sequence returns the name of the + sequence associated with a column, or NULL if no sequence is associated + with the column. The first input parameter is a table name with + optional schema, and the second parameter is a column name. Because + the first parameter is potentially a schema and table, it is not treated + as a double-quoted identifier, meaning it is lowercased by default, + while the second parameter, being just a column name, is treated as + double-quoted and has its case preserved. The function returns a value + suitably formatted for passing to the sequence functions (see ). This association can be modified or + removed with ALTER SEQUENCE OWNED BY. (The function + probably should have been called pg_get_owned_sequence; its name reflects the fact that it's typically used with serial or bigserial columns.) diff --git a/src/backend/utils/adt/ruleutils.c b/src/backend/utils/adt/ruleutils.c index adcc987e5d7..7b57c5bb11c 100644 --- a/src/backend/utils/adt/ruleutils.c +++ b/src/backend/utils/adt/ruleutils.c @@ -2,7 +2,7 @@ * ruleutils.c - Functions to convert stored expressions/querytrees * back to source text * - * $PostgreSQL: pgsql/src/backend/utils/adt/ruleutils.c,v 1.235.2.1 2007/01/25 04:17:56 momjian Exp $ + * $PostgreSQL: pgsql/src/backend/utils/adt/ruleutils.c,v 1.235.2.2 2007/01/30 02:32:05 momjian Exp $ **********************************************************************/ #include "postgres.h" @@ -1232,6 +1232,8 @@ pg_get_userbyid(PG_FUNCTION_ARGS) * pg_get_serial_sequence * Get the name of the sequence used by a serial column, * formatted suitably for passing to setval, nextval or currval. + * First parameter is not treated as double-quoted, second parameter + * is --- see documentation for reason. */ Datum pg_get_serial_sequence(PG_FUNCTION_ARGS)