From: | Alvaro Herrera <alvherre(at)commandprompt(dot)com> |
---|---|
To: | Greg Stark <stark(at)mit(dot)edu> |
Cc: | "<pgsql-hackers(at)postgresql(dot)org>" <pgsql-hackers(at)postgresql(dot)org>, Greg Smith <greg(at)2ndquadrant(dot)com> |
Subject: | Re: Word-smithing doc changes |
Date: | 2011-06-28 17:26:23 |
Message-ID: | 1309281842-sup-9175@alvh.no-ip.org |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
Excerpts from Greg Stark's message of sáb jun 25 21:01:36 -0400 2011:
> I think this commit was ill-advised:
> http://git.postgresql.org/gitweb?p=postgresql.git;a=commitdiff;h=a03feb9354bda5084f19cc952bc52ba7be89f372
> Seems way to implementation-specific and detailed for a user to make
> heads or tails of. Except in the sections talking about locking
> internals we don't talk about "shared locks on virtual transactions
> identifiers" we just talk about waiting for a transaction to complete.
Hmm, right.
> And looping over the transactions one by one is purely an
> implementation detail and uninteresting to users. Also it uses
> ill-defined terms like "active transactions", "potentially interfering
> older transactions", and "original index" -- from the user's point of
> view there's only one index and it just isn't completely built yet.
Wow, that's a lot of mistakes for a single paragraph, sorry about that.
> Are we not yet in string-freeze though? I'll go ahead and edit it if
> people don't mind. I'm curious to see the original complaint though.
I don't -- please go ahead.
Original complaint in Message-id 4DDB64CB(dot)7070109(at)2ndQuadrant(dot)com
--
Álvaro Herrera <alvherre(at)commandprompt(dot)com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support
From | Date | Subject | |
---|---|---|---|
Next Message | Alvaro Herrera | 2011-06-28 17:45:33 | Re: [COMMITTERS] pgsql: Branch refs/heads/REL9_1_STABLE was removed |
Previous Message | Robert Haas | 2011-06-28 17:24:32 | Re: Range Types, constructors, and the type system |