pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
Spelling of lock names
2+ messages / 2 participants
[nested] [flat]

* Spelling of lock names
@ 2002-03-22 17:55  Peter Eisentraut <peter_e@gmx.net>
  0 siblings, 1 reply; 2+ messages in thread

From: Peter Eisentraut @ 2002-03-22 17:55 UTC (permalink / raw)
  To: pgsql-docs

I plan to change the names of the locks in the MVCC chapter from

  AccessShareLock
  ShareRowExclusiveLock
  etc.

to

  access-share lock
  share-row-exclusive lock
  etc.

unless someone has a better idea.

The current spelling corresponds to the internal identifier names, but not
to any user-level command syntax, so I don't consider it appropriate for
user-level documentation.

-- 
Peter Eisentraut   peter_e@gmx.net




^ permalink  raw  reply  [nested|flat] 2+ messages in thread

* Re: Spelling of lock names
@ 2002-03-22 18:35  Tom Lane <tgl@sss.pgh.pa.us>
  parent: Peter Eisentraut <peter_e@gmx.net>
  0 siblings, 0 replies; 2+ messages in thread

From: Tom Lane @ 2002-03-22 18:35 UTC (permalink / raw)
  To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs

Peter Eisentraut <peter_e@gmx.net> writes:
> The current spelling corresponds to the internal identifier names, but not
> to any user-level command syntax, so I don't consider it appropriate for
> user-level documentation.

I agree that the internal coding should not dictate what the
documentation uses, but I'm not sure that I see the improvement from
	ShareRowExclusiveLock
to
	share-row-exclusive lock
when the thing the user might actually write is
	LOCK foo IN SHARE ROW EXCLUSIVE MODE

It'd seem that
	SHARE ROW EXCLUSIVE lock
(perhaps font-ifying what I've upcased here) would be the closest thing
to the user-visible syntax.

			regards, tom lane



^ permalink  raw  reply  [nested|flat] 2+ messages in thread


end of thread, other threads:[~2002-03-22 18:35 UTC | newest]

Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2002-03-22 17:55 Spelling of lock names Peter Eisentraut <peter_e@gmx.net>
2002-03-22 18:35 ` Tom Lane <tgl@sss.pgh.pa.us>

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox