On 10/17/07, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> "Marko Kreen" <markokr@gmail.com> writes:
> > Thanks. Here is a version with your changes applied, plus
> > minor code cleanup and example output.
>
> I can't really see the reasoning for putting this into the PG
> documentation. It's tremendously complicated and doesn't seem like
> something very many people would want to read about. In any case
> it seems rather out of place where it is --- we don't have large
> code examples elsewhere in func.sgml.
>
> It almost looks like something that should be turned into a pgfoundry
> or contrib module.
The whole point of the functions it to allow doing snapshot-based
queries. It is indeed tricky, but that increases the need for
documentaton, no?
I think the last "more realistic code" section can be dropped,
it shows more user-friendly function but adds nothing new,
and the code is rather unreadeable.
--
marko