Re: [RFC] extended txid docs

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Marko Kreen <markokr(at)gmail(dot)com>
Cc: Chris Browne <cbbrowne(at)acm(dot)org>, pgsql-patches(at)postgresql(dot)org
Subject: Re: [RFC] extended txid docs
Date: 2007-11-05 15:23:16
Message-ID: 200711051523.lA5FNG507943@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers pgsql-patches

Marko Kreen wrote:
> On 10/16/07, Chris Browne <cbbrowne(at)acm(dot)org> wrote:
> > markokr(at)gmail(dot)com ("Marko Kreen") writes:
> > > Even the realistic code may be too much for general docs,
> > > but considering this is not a functionality covered
> > > by general SQL textbooks, I think it is worth having.
> > >
> > > I also put rendered pages up here:
> > > http://skytools.projects.postgresql.org/txid/datatype-txid-snapshot.html
> >
> > > http://skytools.projects.postgresql.org/txid/functions-txid.html
> >
> > I believe that those suggested texts describe what you intended, and
> > they should represent better English text for this.
>
> Thanks. Here is a version with your changes applied, plus
> minor code cleanup and example output.
>
> I uploaded full docs to above urls, should be easier to browse.

I have applied part of your patch that documents the txid components in
the datatype section. I didn't apply any of your example usage. I just
added the mention that:

The main use of these functions is to determine which transactions
were committed between two snapshots.

If you want to put those examples on a web site or pgfoundry, we can
link to it from the documentation.

Applied patch attached.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

Attachment Content-Type Size
/rtmp/diff2 text/x-diff 4.7 KB

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2007-11-05 15:29:55 Re: minimal update
Previous Message Tom Lane 2007-11-05 15:20:43 plpgsql keywords are hidden reserved words

Browse pgsql-patches by date

  From Date Subject
Next Message Bruce Momjian 2007-11-05 16:11:04 Re: Patch for testing query modes on pgbench
Previous Message Alvaro Herrera 2007-11-05 14:23:24 Re: pg_ctl configurable timeout