Joe Conway <mail(at)joeconway(dot)com> writes:
> For a similar reason I was thinking that only the system view should be
> documented, not the function. Is that the right thing to do?
Probably so. Given the notational inconvenience of having to specify
the RECORD output type, I can't see much reason why people would want
to call the function directly, as opposed to selecting from the view.
regards, tom lane