Word-smithing doc changes - Mailing list pgsql-hackers

From Greg Stark
Subject Word-smithing doc changes
Date
Msg-id BANLkTikCz3Mc8c6pkQJJz7jnw7wdxfUWVg@mail.gmail.com
Whole thread Raw
Responses Re: Word-smithing doc changes
Re: Word-smithing doc changes
List pgsql-hackers
I think this commit was ill-advised:
http://git.postgresql.org/gitweb?p=postgresql.git;a=commitdiff;h=a03feb9354bda5084f19cc952bc52ba7be89f372
    In a concurrent index build, the index is actually entered into the    system catalogs in one transaction, then the
twotable scans occur in a
 
-    second and third transaction.
+    second and third transaction.  All active transactions at the time the
+    second table scan starts, not just ones that already involve the table,
+    have the potential to block the concurrent index creation until they
+    finish.  When checking for transactions that could still use the original
+    index, concurrent index creation advances through potentially interfering
+    older transactions one at a time, obtaining shared locks on their virtual
+    transaction identifiers to wait for them to complete.


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.
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.

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.

-- 
greg


pgsql-hackers by date:

Previous
From: Greg Stark
Date:
Subject: Re: spinlock contention
Next
From: Jeff Davis
Date:
Subject: Range Types and length function