MIME-Version: 1.0
From: Robert Treat <rob@xzilla.net>
Date: Tue, 12 Aug 2025 19:16:40 -0400
Message-ID: 
 <CABV9wwPQnkeo_G6-orMGnHPK9SXGVWm7ajJPzsbE6944tDx=hQ@mail.gmail.com>
Subject: Index / glossary adjustments for Git & GUC
To: pgsql-docs@lists.postgresql.org
Content-Type: multipart/mixed; boundary="00000000000052903e063c333c93"
Archived-At: 
 <https://www.postgresql.org/message-id/CABV9wwPQnkeo_G6-orMGnHPK9SXGVWm7ajJPzsbE6944tDx%3DhQ%40mail.gmail.com>
Precedence: bulk

--00000000000052903e063c333c93
Content-Type: text/plain; charset="UTF-8"

Howdy folks,

Two small "clean up" patches. These are against HEAD, though could
likely be backpatched to v18 if one were inclined.

The first patch removes the term "Git" from the acronyms section and
instead creates an index entry that points to our source repository
information.

For the second, ISTM we use the term GUC to refer to parameters pretty
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.

Robert Treat
https://xzilla.net

--00000000000052903e063c333c93
Content-Type: application/octet-stream;
	name="v1-0001-Remove-git-from-the-acronyms-section-since-it-is-.patch"
Content-Disposition: attachment;
	filename="v1-0001-Remove-git-from-the-acronyms-section-since-it-is-.patch"
Content-Transfer-Encoding: base64
Content-ID: <f_me95rnjq0>
X-Attachment-Id: f_me95rnjq0

RnJvbSBjMTg0YmY3ZTcxNWU1MmYxMzhiNWUzODA5YmQ2NWE5Mjk0YjIzZDhiIE1vbiBTZXAgMTcg
MDA6MDA6MDAgMjAwMQpGcm9tOiBSb2JlcnQgVHJlYXQgPHJvYkB4emlsbGEubmV0PgpEYXRlOiBU
dWUsIDEyIEF1ZyAyMDI1IDE4OjExOjQwIC0wNDAwClN1YmplY3Q6IFtQQVRDSCB2MSAxLzJdIFJl
bW92ZSBnaXQgZnJvbSB0aGUgYWNyb255bXMgc2VjdGlvbiwgc2luY2UgaXQgaXMgbm90CiBvbmUu
IEFkZCBlbnRyeSBpbiB0aGUgaW5kZXgsIHBvaW50aW5nIHRvd2FyZHMgb3VyIHJlcG8gaW5mby4K
Q29udGVudC1UeXBlOiB0ZXh0L3BhdGNoOyBjaGFyc2V0PSJ1dGYtOCIKCi0tLQogZG9jL3NyYy9z
Z21sL2Fjcm9ueW1zLnNnbWwgICB8IDEwIC0tLS0tLS0tLS0KIGRvYy9zcmMvc2dtbC9zb3VyY2Vy
ZXBvLnNnbWwgfCAgMiArKwogMiBmaWxlcyBjaGFuZ2VkLCAyIGluc2VydGlvbnMoKyksIDEwIGRl
bGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9hY3Jvbnltcy5zZ21sIGIvZG9j
L3NyYy9zZ21sL2Fjcm9ueW1zLnNnbWwKaW5kZXggMmY5MDZlOWYwMTguLjUxMWM3ZmQxYTVkIDEw
MDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvYWNyb255bXMuc2dtbAorKysgYi9kb2Mvc3JjL3NnbWwv
YWNyb255bXMuc2dtbApAQCAtMjczLDE2ICsyNzMsNiBAQAogICAgIDwvbGlzdGl0ZW0+CiAgICA8
L3Zhcmxpc3RlbnRyeT4KIAotICAgPHZhcmxpc3RlbnRyeT4KLSAgICA8dGVybT48YWNyb255bT5H
aXQ8L2Fjcm9ueW0+PC90ZXJtPgotICAgIDxsaXN0aXRlbT4KLSAgICAgPHBhcmE+Ci0gICAgICA8
dWxpbmsKLSAgICAgIHVybD0iaHR0cHM6Ly9lbi53aWtpcGVkaWEub3JnL3dpa2kvR2l0Ij5HaXQ8
L3VsaW5rPgotICAgICA8L3BhcmE+Ci0gICAgPC9saXN0aXRlbT4KLSAgIDwvdmFybGlzdGVudHJ5
PgotCiAgICA8dmFybGlzdGVudHJ5PgogICAgIDx0ZXJtPjxhY3JvbnltPkdNVDwvYWNyb255bT48
L3Rlcm0+CiAgICAgPGxpc3RpdGVtPgpkaWZmIC0tZ2l0IGEvZG9jL3NyYy9zZ21sL3NvdXJjZXJl
cG8uc2dtbCBiL2RvYy9zcmMvc2dtbC9zb3VyY2VyZXBvLnNnbWwKaW5kZXggNmMxM2M1YTMwY2Qu
LjNlY2I0Y2Q3Zjc2IDEwMDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvc291cmNlcmVwby5zZ21sCisr
KyBiL2RvYy9zcmMvc2dtbC9zb3VyY2VyZXBvLnNnbWwKQEAgLTMsNiArMyw4IEBACiA8YXBwZW5k
aXggaWQ9InNvdXJjZXJlcG8iPgogIDx0aXRsZT5UaGUgU291cmNlIENvZGUgUmVwb3NpdG9yeTwv
dGl0bGU+CiAKKyA8aW5kZXh0ZXJtIHpvbmU9InNvdXJjZXJlcG8iPjxwcmltYXJ5PkdpdDwvcHJp
bWFyeT48L2luZGV4dGVybT4KKwogIDxwYXJhPgogICBUaGUgPHByb2R1Y3RuYW1lPlBvc3RncmVT
UUw8L3Byb2R1Y3RuYW1lPiBzb3VyY2UgY29kZSBpcyBzdG9yZWQgYW5kIG1hbmFnZWQKICAgdXNp
bmcgdGhlIDxwcm9kdWN0bmFtZT5HaXQ8L3Byb2R1Y3RuYW1lPiB2ZXJzaW9uIGNvbnRyb2wgc3lz
dGVtLiBBIHB1YmxpYwotLSAKMi4yNC4zIChBcHBsZSBHaXQtMTI4KQoK
--00000000000052903e063c333c93
Content-Type: application/octet-stream;
	name="v1-0002-GUC-is-a-pretty-common-term-which-currently-only-.patch"
Content-Disposition: attachment;
	filename="v1-0002-GUC-is-a-pretty-common-term-which-currently-only-.patch"
Content-Transfer-Encoding: base64
Content-ID: <f_me95rnkx1>
X-Attachment-Id: f_me95rnkx1

RnJvbSA0OGQwOWNkMmM2ZmVmNzg1OTJiNTcwYTk0NThlNDE1MTJkYmI0NDVlIE1vbiBTZXAgMTcg
MDA6MDA6MDAgMjAwMQpGcm9tOiBSb2JlcnQgVHJlYXQgPHJvYkB4emlsbGEubmV0PgpEYXRlOiBU
dWUsIDEyIEF1ZyAyMDI1IDE5OjA1OjAyIC0wNDAwClN1YmplY3Q6IFtQQVRDSCB2MSAyLzJdIEdV
QyBpcyBhIHByZXR0eSBjb21tb24gdGVybSwgd2hpY2ggY3VycmVudGx5IG9ubHkKIHNob3dzIHVw
IGluIGFjcm9ueW0sIGFuZCAjNyBzZWFyY2ggdGVybSBvbiB3ZWJzaXRlLCBzbyBhZGQgaW5kZXgg
YW5kIGdsb3NzYXJ5CiBlbnRyaWVzLgpDb250ZW50LVR5cGU6IHRleHQvcGF0Y2g7IGNoYXJzZXQ9
InV0Zi04IgoKLS0tCiBkb2Mvc3JjL3NnbWwvY29uZmlnLnNnbWwgICB8ICAyICsrCiBkb2Mvc3Jj
L3NnbWwvZ2xvc3Nhcnkuc2dtbCB8IDE1ICsrKysrKysrKysrKysrKwogMiBmaWxlcyBjaGFuZ2Vk
LCAxNyBpbnNlcnRpb25zKCspCgpkaWZmIC0tZ2l0IGEvZG9jL3NyYy9zZ21sL2NvbmZpZy5zZ21s
IGIvZG9jL3NyYy9zZ21sL2NvbmZpZy5zZ21sCmluZGV4IDIwY2NiMmQ2YjU0Li5lMTJkMWZmMzA4
NyAxMDA2NDQKLS0tIGEvZG9jL3NyYy9zZ21sL2NvbmZpZy5zZ21sCisrKyBiL2RvYy9zcmMvc2dt
bC9jb25maWcuc2dtbApAQCAtMTgsNiArMTgsOCBAQAogICA8c2VjdDEgaWQ9ImNvbmZpZy1zZXR0
aW5nIj4KICAgIDx0aXRsZT5TZXR0aW5nIFBhcmFtZXRlcnM8L3RpdGxlPgogCisgICA8aW5kZXh0
ZXJtPjxwcmltYXJ5PkdVQzwvcHJpbWFyeT48L2luZGV4dGVybT4KKwogICAgPHNlY3QyIGlkPSJj
b25maWctc2V0dGluZy1uYW1lcy12YWx1ZXMiPgogICAgIDx0aXRsZT5QYXJhbWV0ZXIgTmFtZXMg
YW5kIFZhbHVlczwvdGl0bGU+CiAKZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9nbG9zc2FyeS5z
Z21sIGIvZG9jL3NyYy9zZ21sL2dsb3NzYXJ5LnNnbWwKaW5kZXggYjg4Y2FjNTk4ZTkuLjA4Njkw
OWM3MzA1IDEwMDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvZ2xvc3Nhcnkuc2dtbAorKysgYi9kb2Mv
c3JjL3NnbWwvZ2xvc3Nhcnkuc2dtbApAQCAtODk3LDYgKzg5NywyMSBAQAogICAgPC9nbG9zc2Rl
Zj4KICAgPC9nbG9zc2VudHJ5PgogCisgIDxnbG9zc2VudHJ5IGlkPSJnbG9zc2FyeS1ndWMiPgor
ICAgPGdsb3NzdGVybT5HVUM8L2dsb3NzdGVybT4KKyAgIDxnbG9zc2RlZj4KKyAgICA8cGFyYT4K
KyAgICAgQ29tbW9ubHkgdXNlZCB0ZXJtIHdpdGhpbiA8cHJvZHVjdG5hbWU+UG9zdGdyZVNRTDwv
cHJvZHVjdG5hbWU+IGZvcgorICAgICBjb25maWd1cmF0aW9uIHBhcmFtZXRlcnMuIFR5cGljYWxs
eSBtZWFudCB0byByZWZlciB0byB1c2VyIHNldHRhYmxlCisgICAgIHBhcmFtZXRlcnMsIGJ1dCBp
dCBjYW4gYWxzbyByZWZlciB0byBpbnRlcm5hbCBvciBidWlsZC10aW1lIHBhcmFtZXRlcnMuCisg
ICAgPC9wYXJhPgorICAgIDxwYXJhPgorICAgICBGb3IgaW5mb3JtYXRpb24gb24gd29ya2luZyB3
aXRoIGNvbmZpZ3VyYXRpb24gcGFyYW1ldGVycywgc2VlCisgICAgIDx4cmVmIGxpbmtlbmQ9ImNv
bmZpZy1zZXR0aW5nIi8+LgorICAgIDwvcGFyYT4KKyAgIDwvZ2xvc3NkZWY+CisgIDwvZ2xvc3Nl
bnRyeT4KKwogICA8Z2xvc3NlbnRyeSBpZD0iZ2xvc3NhcnktaGVhcCI+CiAgICA8Z2xvc3N0ZXJt
PkhlYXA8L2dsb3NzdGVybT4KICAgIDxnbG9zc2RlZj4KLS0gCjIuMjQuMyAoQXBwbGUgR2l0LTEy
OCkKCg==
--00000000000052903e063c333c93--