Re: [RFC] extended txid docs

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