Re: DROP INDEX docs - explicit lock naming - Mailing list pgsql-hackers

From Michael Paquier
Subject Re: DROP INDEX docs - explicit lock naming
Date
Msg-id YGPGlNbbDbvl5gHr@paquier.xyz
Whole thread Raw
In response to DROP INDEX docs - explicit lock naming  (Greg Rychlewski <greg.rychlewski@gmail.com>)
Responses Re: DROP INDEX docs - explicit lock naming  (Greg Rychlewski <greg.rychlewski@gmail.com>)
List pgsql-hackers
On Tue, Mar 30, 2021 at 10:33:46AM -0400, Greg Rychlewski wrote:
> While reading the documentation for DROP INDEX[1], I noticed the lock was
> described colloquially as an "exclusive" lock, which made me pause for a
> second because it's the same name as the EXCLUSIVE table lock.
>
> The attached patch explicitly states that an ACCESS EXCLUSIVE lock is
> acquired.

Indeed, this could be read as ACCESS SHARE being allowed, but that's
never the case for any of the index code paths, except if CONCURRENTLY
is involved.  It is not the only place in the docs where we could do
more clarification.  For instance, reindex.sgml mentions twice an
exclusive lock but that should be an access exclusive lock.  To be
exact, I can spot 27 places under doc/ that could be improved.  Such
changes depend on the surrounding context, of course.
--
Michael

Attachment

pgsql-hackers by date:

Previous
From: Andy Fan
Date:
Subject: Re: Keep notnullattrs in RelOptInfo (Was part of UniqueKey patch series)
Next
From: "tsunakawa.takay@fujitsu.com"
Date:
Subject: RE: libpq debug log