Glossary and initdb definition work for "superuser" and database/cluster

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: Pg Hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Glossary and initdb definition work for "superuser" and database/cluster
Date: 2022-11-01 22:47:15
Message-ID: CAKFQuwZC4K0XYBm0bwBMDOZySBqhOSekDhLuaw4vPi+ozi8gqQ@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Hey,

Recent threads have pointed out some long-standing doc language in initdb
that could be made more precise, especially in light of the relatively
recent addition of a glossary. Toward this end I'm attaching a patch that
defines three terms: "bootstrap superuser", "database superuser" and
"superuser". I didn't add any extra-glossary links for the later two but
did for the limited-in-scope bootstrap superuser that is really only
defined in initdb (actually, I suspect the authorization docs could use a
link too but haven't gone looking for an appropriate place yet).

In passing I also changed a few places where the documentation says
"database" when the thing being referred to is basically the file system
data directory, which is a cluster-scoped thing.

I did some grep'ing, though another pass or two is probably worthwhile.
For now I submit a preliminary patch for consideration and buy-in before
trying to polish it up.

David J.

Attachment Content-Type Size
initdb-and-glossary.diff application/octet-stream 8.9 KB

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Andres Freund 2022-11-01 22:54:02 Re: Direct I/O
Previous Message Justin Pryzby 2022-11-01 22:26:34 Re: warn if GUC set to an invalid shared library