"David G. Johnston" <david.g.johnston@gmail.com> writes:
> As I look at this more I'm definitely agreeing that the documentation here
> is problematic. Specifically, the fact that the only place about this
> syntax is in a chapter under Extending SQ - SQL Functions, is not good. It
> really needs to be in the Syntax chapter.
The documentation situation was complained of in the 2009 thread I just
cited :-(. Doesn't look like anybody did anything about it.
I am not, however, persuaded that you can just move a bunch of that
material to the syntax chapter. I don't think it's very practical
to describe variadic functions when the user doesn't know how to
create one. And we definitely should not push all the docs about
creating functions into the syntax chapter.
regards, tom lane