MIME-Version: 1.0
References: 
 <CABV9wwPQnkeo_G6-orMGnHPK9SXGVWm7ajJPzsbE6944tDx=hQ@mail.gmail.com>
 <FFBAE5D1-F0E6-4983-80B3-82FF0B1CF6F5@yesql.se>
 <CAHGQGwETTsf8ZFKWO3aVu-b6bQuNLS5PT2qx7NaxYMz-U2b1nA@mail.gmail.com>
 <CAJSLCQ3ZpgA6d3RNbzz6h4Gv=xR70ZTgF65ayS7eDZrd_UhN2A@mail.gmail.com>
In-Reply-To: 
 <CAJSLCQ3ZpgA6d3RNbzz6h4Gv=xR70ZTgF65ayS7eDZrd_UhN2A@mail.gmail.com>
From: Robert Treat <rob@xzilla.net>
Date: Wed, 31 Dec 2025 10:39:20 -0500
Message-ID: 
 <CAJSLCQ2iU3uEkPa1Ste4u-Lm574Z20+xy4TnDnXvrLrKkG44fg@mail.gmail.com>
Subject: Re: Index / glossary adjustments for Git & GUC
To: Fujii Masao <masao.fujii@gmail.com>
Cc: Daniel Gustafsson <daniel@yesql.se>, pgsql-docs@lists.postgresql.org
Content-Type: multipart/mixed; boundary="0000000000005700c8064741489b"
Archived-At: 
 <https://www.postgresql.org/message-id/CAJSLCQ2iU3uEkPa1Ste4u-Lm574Z20%2Bxy4TnDnXvrLrKkG44fg%40mail.gmail.com>
Precedence: bulk

--0000000000005700c8064741489b
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Fri, Aug 15, 2025 at 12:12=E2=80=AFAM Robert Treat <rob@xzilla.net> wrot=
e:
> On Wed, Aug 13, 2025 at 10:48=E2=80=AFPM Fujii Masao <masao.fujii@gmail.c=
om> wrote:
> > On Wed, Aug 13, 2025 at 5:04=E2=80=AFPM Daniel Gustafsson <daniel@yesql=
.se> wrote:
> > > > On 13 Aug 2025, at 01:16, Robert Treat <rob@xzilla.net> wrote:
> > >
> > > > The first patch removes the term "Git" from the acronyms section an=
d
> > > > instead creates an index entry that points to our source repository
> > > > information.
> > >
> > > This was previously discussed in this thread:
> > >
> > > https://postgr.es/m/8241CED6-F408-4660-A1AA-F3393AA26219%40yesql.se
> > >
> > > > For the second, ISTM we use the term GUC to refer to parameters pre=
tty
> > > > liberally, but the term is not that easy to find in the docs (and
> > > > website search gives what is probably the best answer as result #7 =
of
> > > > 8). This creates an index entry for the term, as well as a glossary
> > > > entry which explains how it is commonly used.
> > >
> > > This seems like a good idea.
> >
> > +1
> >
> > +  <glossentry id=3D"glossary-guc">
> > +   <glossterm>GUC</glossterm>
> >
> > Should we also include the full term "Grand Unified Configuration" here=
, e.g.,
> > "Grand unified configuration (GUC)", similar to how "Log sequence numbe=
r (LSN)"
> > is shown in the glossary? Even though it's already in the acronyms docs=
,
> > it might be helpful to include it in the glossary as well.
> >
>

Howdy folks,

While doing some end of year clean up, I noticed I hadn't followed up
on this thread, so attached is an updated set of patches, the first of
which adds the index entry for git, and the second which adds the
glossary entry for GUC, both in accordance with the above feedback.


Robert Treat
https://xzilla.net

--0000000000005700c8064741489b
Content-Type: application/octet-stream;
	name="v2-0001-Add-Git-to-the-index-pointing-towards-repo-info.patch"
Content-Disposition: attachment;
	filename="v2-0001-Add-Git-to-the-index-pointing-towards-repo-info.patch"
Content-Transfer-Encoding: base64
Content-ID: <f_mju6l8xa0>
X-Attachment-Id: f_mju6l8xa0

RnJvbSBjNjM1ZjU0ZjMwZmU3MWM5OGMyNDNjYjg5NTA1MWYwNGVhMDQyMTBlIE1vbiBTZXAgMTcg
MDA6MDA6MDAgMjAwMQpGcm9tOiBSb2JlcnQgVHJlYXQgPHJvYkB4emlsbGEubmV0PgpEYXRlOiBU
dWUsIDEyIEF1ZyAyMDI1IDE4OjExOjQwIC0wNDAwClN1YmplY3Q6IFtQQVRDSCB2MiAxLzJdIEFk
ZCBHaXQgdG8gdGhlIGluZGV4LCBwb2ludGluZyB0b3dhcmRzIHJlcG8gaW5mby4KQ29udGVudC1U
eXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PSJ1dGYtOCIKCi0tLQogZG9jL3NyYy9zZ21sL3NvdXJj
ZXJlcG8uc2dtbCB8IDIgKysKIDEgZmlsZSBjaGFuZ2VkLCAyIGluc2VydGlvbnMoKykKCmRpZmYg
LS1naXQgYS9kb2Mvc3JjL3NnbWwvc291cmNlcmVwby5zZ21sIGIvZG9jL3NyYy9zZ21sL3NvdXJj
ZXJlcG8uc2dtbAppbmRleCBmNDM2OGU4M2FiMy4uYjllYTU5YWUzMjkgMTAwNjQ0Ci0tLSBhL2Rv
Yy9zcmMvc2dtbC9zb3VyY2VyZXBvLnNnbWwKKysrIGIvZG9jL3NyYy9zZ21sL3NvdXJjZXJlcG8u
c2dtbApAQCAtMyw2ICszLDggQEAKIDxhcHBlbmRpeCBpZD0ic291cmNlcmVwbyI+CiAgPHRpdGxl
PlRoZSBTb3VyY2UgQ29kZSBSZXBvc2l0b3J5PC90aXRsZT4KIAorIDxpbmRleHRlcm0gem9uZT0i
c291cmNlcmVwbyI+PHByaW1hcnk+R2l0PC9wcmltYXJ5PjwvaW5kZXh0ZXJtPgorCiAgPHBhcmE+
CiAgIFRoZSA8cHJvZHVjdG5hbWU+UG9zdGdyZVNRTDwvcHJvZHVjdG5hbWU+IHNvdXJjZSBjb2Rl
IGlzIHN0b3JlZCBhbmQgbWFuYWdlZAogICB1c2luZyB0aGUgPHByb2R1Y3RuYW1lPkdpdDwvcHJv
ZHVjdG5hbWU+IHZlcnNpb24gY29udHJvbCBzeXN0ZW0uIEEgcHVibGljCi0tIAoyLjI0LjMgKEFw
cGxlIEdpdC0xMjgpCgo=
--0000000000005700c8064741489b
Content-Type: application/octet-stream;
	name="v2-0002-GUC-is-a-pretty-common-term-which-currently-only-.patch"
Content-Disposition: attachment;
	filename="v2-0002-GUC-is-a-pretty-common-term-which-currently-only-.patch"
Content-Transfer-Encoding: base64
Content-ID: <f_mju6l8xj1>
X-Attachment-Id: f_mju6l8xj1

RnJvbSA0MzQ5Y2ViN2Y5NGExNjZkNDI3NGIwNTRmNTgwYmU5MmJjMjY4MDhjIE1vbiBTZXAgMTcg
MDA6MDA6MDAgMjAwMQpGcm9tOiBSb2JlcnQgVHJlYXQgPHJvYkB4emlsbGEubmV0PgpEYXRlOiBU
dWUsIDEyIEF1ZyAyMDI1IDE5OjA1OjAyIC0wNDAwClN1YmplY3Q6IFtQQVRDSCB2MiAyLzJdIEdV
QyBpcyBhIHByZXR0eSBjb21tb24gdGVybSwgd2hpY2ggY3VycmVudGx5IG9ubHkKIHNob3dzIHVw
IGluIGFjcm9ueW0sIGFuZCAjNyBzZWFyY2ggdGVybSBvbiB3ZWJzaXRlLCBzbyBhZGQgaW5kZXgg
YW5kIGdsb3NzYXJ5CiBlbnRyaWVzLgpDb250ZW50LVR5cGU6IHRleHQvcGxhaW47IGNoYXJzZXQ9
InV0Zi04IgoKLS0tCiBkb2Mvc3JjL3NnbWwvY29uZmlnLnNnbWwgICB8ICAyICsrCiBkb2Mvc3Jj
L3NnbWwvZ2xvc3Nhcnkuc2dtbCB8IDE3ICsrKysrKysrKysrKysrKysrCiAyIGZpbGVzIGNoYW5n
ZWQsIDE5IGluc2VydGlvbnMoKykKCmRpZmYgLS1naXQgYS9kb2Mvc3JjL3NnbWwvY29uZmlnLnNn
bWwgYi9kb2Mvc3JjL3NnbWwvY29uZmlnLnNnbWwKaW5kZXggY2RmZThlMzc2ZjAuLjc1NWE2ZTE5
YWY3IDEwMDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvY29uZmlnLnNnbWwKKysrIGIvZG9jL3NyYy9z
Z21sL2NvbmZpZy5zZ21sCkBAIC0xOCw2ICsxOCw4IEBACiAgIDxzZWN0MSBpZD0iY29uZmlnLXNl
dHRpbmciPgogICAgPHRpdGxlPlNldHRpbmcgUGFyYW1ldGVyczwvdGl0bGU+CiAKKyAgIDxpbmRl
eHRlcm0+PHByaW1hcnk+R1VDPC9wcmltYXJ5PjwvaW5kZXh0ZXJtPgorCiAgICA8c2VjdDIgaWQ9
ImNvbmZpZy1zZXR0aW5nLW5hbWVzLXZhbHVlcyI+CiAgICAgPHRpdGxlPlBhcmFtZXRlciBOYW1l
cyBhbmQgVmFsdWVzPC90aXRsZT4KIApkaWZmIC0tZ2l0IGEvZG9jL3NyYy9zZ21sL2dsb3NzYXJ5
LnNnbWwgYi9kb2Mvc3JjL3NnbWwvZ2xvc3Nhcnkuc2dtbAppbmRleCBhNzZjZjVjMzgzZi4uZTJk
YjViY2M3OGMgMTAwNjQ0Ci0tLSBhL2RvYy9zcmMvc2dtbC9nbG9zc2FyeS5zZ21sCisrKyBiL2Rv
Yy9zcmMvc2dtbC9nbG9zc2FyeS5zZ21sCkBAIC05MTIsNiArOTEyLDIzIEBACiAgICA8L2dsb3Nz
ZGVmPgogICA8L2dsb3NzZW50cnk+CiAKKyAgPGdsb3NzZW50cnkgaWQ9Imdsb3NzYXJ5LWd1YyI+
CisgICA8Z2xvc3N0ZXJtPkdVQzwvZ2xvc3N0ZXJtPgorICAgPGdsb3NzZGVmPgorICAgIDxwYXJh
PgorICAgICBCYXNlZCBvbiBhIHNob3J0LWhhbmQgZm9yIEdyYW5kIFVuaWZpZWQgQ29uZmlndXJh
dGlvbiwgdGhlIHN1YnN5c3RlbQorICAgICB3aGljaCBjb250cm9scyBzZXJ2ZXIgY29uZmlndXJh
dGlvbiwgaXQgaXMgbm93IGEgY29tbW9ubHkgdXNlZCB0ZXJtCisgICAgIGZvciB0aGUgaW5kaXZp
ZHVhbCBjb25maWd1cmF0aW9uIHBhcmFtZXRlcnMgdGhlbXNlbHZlcy4gVHlwaWNhbGx5IG1lYW50
CisgICAgIHRvIHJlZmVyIHRvIHVzZXIgc2V0dGFibGUgcGFyYW1ldGVycywgaXQgY2FuIGFsc28g
cmVmZXIgdG8gaW50ZXJuYWwgb3IKKyAgICAgYnVpbGQtdGltZSBwYXJhbWV0ZXJzLgorICAgIDwv
cGFyYT4KKyAgICA8cGFyYT4KKyAgICAgRm9yIGluZm9ybWF0aW9uIG9uIHdvcmtpbmcgd2l0aCBj
b25maWd1cmF0aW9uIHBhcmFtZXRlcnMsIHNlZQorICAgICA8eHJlZiBsaW5rZW5kPSJjb25maWct
c2V0dGluZyIvPi4KKyAgICA8L3BhcmE+CisgICA8L2dsb3NzZGVmPgorICA8L2dsb3NzZW50cnk+
CisKICAgPGdsb3NzZW50cnkgaWQ9Imdsb3NzYXJ5LWhlYXAiPgogICAgPGdsb3NzdGVybT5IZWFw
PC9nbG9zc3Rlcm0+CiAgICA8Z2xvc3NkZWY+Ci0tIAoyLjI0LjMgKEFwcGxlIEdpdC0xMjgpCgo=
--0000000000005700c8064741489b--