Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1uRZES-00DUS6-Uv for pgsql-docs@arkaria.postgresql.org; Tue, 17 Jun 2025 16:32:20 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.94.2) (envelope-from ) id 1uRZEQ-00BHDS-W1 for pgsql-docs@arkaria.postgresql.org; Tue, 17 Jun 2025 16:32:19 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1uRZEQ-00BHC5-Oh for pgsql-docs@lists.postgresql.org; Tue, 17 Jun 2025 16:32:19 +0000 Received: from oss.nttdata.com ([49.212.34.109]) by makus.postgresql.org with smtp (Exim 4.96) (envelope-from ) id 1uRZEO-002WOy-2Y for pgsql-docs@lists.postgresql.org; Tue, 17 Jun 2025 16:32:18 +0000 Received: from [192.168.11.9] (p1696134-ipoe.ipoe.ocn.ne.jp [118.0.93.133]) by oss.nttdata.com (Postfix) with ESMTPSA id 8D80661A72 for ; Wed, 18 Jun 2025 01:32:12 +0900 (JST) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.11 at oss.nttdata.com Content-Type: multipart/mixed; boundary="------------sBcT7gnSnyz3np0yr1E03BRR" Message-ID: Date: Wed, 18 Jun 2025 01:32:11 +0900 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Content-Language: en-US To: pgsql-docs@lists.postgresql.org From: Fujii Masao Subject: Reorder min/max_protocol_version descriptions in libpq documentation List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk This is a multi-part message in MIME format. --------------sBcT7gnSnyz3np0yr1E03BRR Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Hi, Commit 285613c60a7 added the min_protocol_version and max_protocol_version connection options to libpq. However, their descriptions currently appear in the middle of the unrelated ssl_min_protocol_version and ssl_max_protocol_version entries in libpq.sgml. Is there a reason for this placement? To make the documentation more intuitive and easier to navigate, I suggest moving these entries after the SSL-related options. Attached is a patch that does that. Thanks, -- Fujii Masao NTT DATA Japan Corporation --------------sBcT7gnSnyz3np0yr1E03BRR Content-Type: text/plain; charset=UTF-8; name="v1-0001-doc-Reorder-protocol-version-option-descriptions-.patch" Content-Disposition: attachment; filename*0="v1-0001-doc-Reorder-protocol-version-option-descriptions-.pa"; filename*1="tch" Content-Transfer-Encoding: base64 RnJvbSBkZTRiYTNlNzcxODQwMDI0ZjA3YjUxMzJiYWRkZWViMWRkNjExNzA5IE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBGdWppaSBNYXNhbyA8ZnVqaWlAcG9zdGdyZXNxbC5v cmc+CkRhdGU6IFdlZCwgMTggSnVuIDIwMjUgMDE6MDk6MDYgKzA5MDAKU3ViamVjdDogW1BB VENIIHYxXSBkb2M6IFJlb3JkZXIgcHJvdG9jb2wgdmVyc2lvbiBvcHRpb24gZGVzY3JpcHRp b25zIGluIGxpYnBxCiBkb2NzLgoKQ29tbWl0IDI4NTYxM2M2MGE3IGludHJvZHVjZWQgdGhl IG1pbl9wcm90b2NvbF92ZXJzaW9uIGFuZAptYXhfcHJvdG9jb2xfdmVyc2lvbiBjb25uZWN0 aW9uIG9wdGlvbnMgZm9yIGxpYnBxLCBidXQgdGhlaXIgZGVzY3JpcHRpb25zCndlcmUgcGxh Y2VkIGluIHRoZSBtaWRkbGUgb2YgdGhlIHVucmVsYXRlZCBzc2xfbWluX3Byb3RvY29sX3Zl cnNpb24gYW5kCnNzbF9tYXhfcHJvdG9jb2xfdmVyc2lvbiBlbnRyaWVzLgoKVGhpcyBjb21t aXQgbW92ZXMgdGhlIG1pbl9wcm90b2NvbF92ZXJzaW9uIGFuZCBtYXhfcHJvdG9jb2xfdmVy c2lvbgpkZXNjcmlwdGlvbnMgdG8gYXBwZWFyIGFmdGVyIHRoZSBTU0wtcmVsYXRlZCBvcHRp b25zLiBUaGlzIGltcHJvdmVzCnRoZSBsb2dpY2FsIG9yZGVyIGFuZCBtYWtlcyBpdCBlYXNp ZXIgZm9yIHVzZXJzIHRvIGxvY2F0ZSB0aGUgcmVsZXZhbnQKc2V0dGluZ3MgaW4gdGhlIGxp YnBxIGRvY3VtZW50YXRpb24uCi0tLQogZG9jL3NyYy9zZ21sL2xpYnBxLnNnbWwgfCAzNiAr KysrKysrKysrKysrKysrKystLS0tLS0tLS0tLS0tLS0tLS0KIDEgZmlsZSBjaGFuZ2VkLCAx OCBpbnNlcnRpb25zKCspLCAxOCBkZWxldGlvbnMoLSkKCmRpZmYgLS1naXQgYS9kb2Mvc3Jj L3NnbWwvbGlicHEuc2dtbCBiL2RvYy9zcmMvc2dtbC9saWJwcS5zZ21sCmluZGV4IDY5NWZl OTU4YzNlLi4wOGJkNTEyMTkyNiAxMDA2NDQKLS0tIGEvZG9jL3NyYy9zZ21sL2xpYnBxLnNn bWwKKysrIGIvZG9jL3NyYy9zZ21sL2xpYnBxLnNnbWwKQEAgLTIxNjgsNiArMjE2OCwyNCBA QCBwb3N0Z3Jlc3FsOi8vJTJGdmFyJTJGbGliJTJGcG9zdGdyZXNxbC9kYm5hbWUKICAgICAg IDwvbGlzdGl0ZW0+CiAgICAgIDwvdmFybGlzdGVudHJ5PgogCisgICAgIDx2YXJsaXN0ZW50 cnkgaWQ9ImxpYnBxLWNvbm5lY3Qtc3NsLW1heC1wcm90b2NvbC12ZXJzaW9uIiB4cmVmbGFi ZWw9InNzbF9tYXhfcHJvdG9jb2xfdmVyc2lvbiI+CisgICAgICA8dGVybT48bGl0ZXJhbD5z c2xfbWF4X3Byb3RvY29sX3ZlcnNpb248L2xpdGVyYWw+PC90ZXJtPgorICAgICAgPGxpc3Rp dGVtPgorICAgICAgIDxwYXJhPgorICAgICAgICBUaGlzIHBhcmFtZXRlciBzcGVjaWZpZXMg dGhlIG1heGltdW0gU1NML1RMUyBwcm90b2NvbCB2ZXJzaW9uIHRvIGFsbG93CisgICAgICAg IGZvciB0aGUgY29ubmVjdGlvbi4gVmFsaWQgdmFsdWVzIGFyZSA8bGl0ZXJhbD5UTFN2MTwv bGl0ZXJhbD4sCisgICAgICAgIDxsaXRlcmFsPlRMU3YxLjE8L2xpdGVyYWw+LCA8bGl0ZXJh bD5UTFN2MS4yPC9saXRlcmFsPiBhbmQKKyAgICAgICAgPGxpdGVyYWw+VExTdjEuMzwvbGl0 ZXJhbD4uIFRoZSBzdXBwb3J0ZWQgcHJvdG9jb2xzIGRlcGVuZCBvbiB0aGUKKyAgICAgICAg dmVyc2lvbiBvZiA8cHJvZHVjdG5hbWU+T3BlblNTTDwvcHJvZHVjdG5hbWU+IHVzZWQsIG9s ZGVyIHZlcnNpb25zCisgICAgICAgIG5vdCBzdXBwb3J0aW5nIHRoZSBtb3N0IG1vZGVybiBw cm90b2NvbCB2ZXJzaW9ucy4gSWYgbm90IHNldCwgdGhpcworICAgICAgICBwYXJhbWV0ZXIg aXMgaWdub3JlZCBhbmQgdGhlIGNvbm5lY3Rpb24gd2lsbCB1c2UgdGhlIG1heGltdW0gYm91 bmQKKyAgICAgICAgZGVmaW5lZCBieSB0aGUgYmFja2VuZCwgaWYgc2V0LiBTZXR0aW5nIHRo ZSBtYXhpbXVtIHByb3RvY29sIHZlcnNpb24KKyAgICAgICAgaXMgbWFpbmx5IHVzZWZ1bCBm b3IgdGVzdGluZyBvciBpZiBzb21lIGNvbXBvbmVudCBoYXMgaXNzdWVzIHdvcmtpbmcKKyAg ICAgICAgd2l0aCBhIG5ld2VyIHByb3RvY29sLgorICAgICAgIDwvcGFyYT4KKyAgICAgIDwv bGlzdGl0ZW0+CisgICAgIDwvdmFybGlzdGVudHJ5PgorCiAgICAgIDx2YXJsaXN0ZW50cnkg aWQ9ImxpYnBxLWNvbm5lY3QtbWluLXByb3RvY29sLXZlcnNpb24iIHhyZWZsYWJlbD0ibWlu X3Byb3RvY29sX3ZlcnNpb24iPgogICAgICAgPHRlcm0+PGxpdGVyYWw+bWluX3Byb3RvY29s X3ZlcnNpb248L2xpdGVyYWw+PC90ZXJtPgogICAgICAgPGxpc3RpdGVtPgpAQCAtMjIxNiwy NCArMjIzNCw2IEBAIHBvc3RncmVzcWw6Ly8lMkZ2YXIlMkZsaWIlMkZwb3N0Z3Jlc3FsL2Ri bmFtZQogICAgICAgPC9saXN0aXRlbT4KICAgICAgPC92YXJsaXN0ZW50cnk+CiAKLSAgICAg PHZhcmxpc3RlbnRyeSBpZD0ibGlicHEtY29ubmVjdC1zc2wtbWF4LXByb3RvY29sLXZlcnNp b24iIHhyZWZsYWJlbD0ic3NsX21heF9wcm90b2NvbF92ZXJzaW9uIj4KLSAgICAgIDx0ZXJt PjxsaXRlcmFsPnNzbF9tYXhfcHJvdG9jb2xfdmVyc2lvbjwvbGl0ZXJhbD48L3Rlcm0+Ci0g ICAgICA8bGlzdGl0ZW0+Ci0gICAgICAgPHBhcmE+Ci0gICAgICAgIFRoaXMgcGFyYW1ldGVy IHNwZWNpZmllcyB0aGUgbWF4aW11bSBTU0wvVExTIHByb3RvY29sIHZlcnNpb24gdG8gYWxs b3cKLSAgICAgICAgZm9yIHRoZSBjb25uZWN0aW9uLiBWYWxpZCB2YWx1ZXMgYXJlIDxsaXRl cmFsPlRMU3YxPC9saXRlcmFsPiwKLSAgICAgICAgPGxpdGVyYWw+VExTdjEuMTwvbGl0ZXJh bD4sIDxsaXRlcmFsPlRMU3YxLjI8L2xpdGVyYWw+IGFuZAotICAgICAgICA8bGl0ZXJhbD5U TFN2MS4zPC9saXRlcmFsPi4gVGhlIHN1cHBvcnRlZCBwcm90b2NvbHMgZGVwZW5kIG9uIHRo ZQotICAgICAgICB2ZXJzaW9uIG9mIDxwcm9kdWN0bmFtZT5PcGVuU1NMPC9wcm9kdWN0bmFt ZT4gdXNlZCwgb2xkZXIgdmVyc2lvbnMKLSAgICAgICAgbm90IHN1cHBvcnRpbmcgdGhlIG1v c3QgbW9kZXJuIHByb3RvY29sIHZlcnNpb25zLiBJZiBub3Qgc2V0LCB0aGlzCi0gICAgICAg IHBhcmFtZXRlciBpcyBpZ25vcmVkIGFuZCB0aGUgY29ubmVjdGlvbiB3aWxsIHVzZSB0aGUg bWF4aW11bSBib3VuZAotICAgICAgICBkZWZpbmVkIGJ5IHRoZSBiYWNrZW5kLCBpZiBzZXQu IFNldHRpbmcgdGhlIG1heGltdW0gcHJvdG9jb2wgdmVyc2lvbgotICAgICAgICBpcyBtYWlu bHkgdXNlZnVsIGZvciB0ZXN0aW5nIG9yIGlmIHNvbWUgY29tcG9uZW50IGhhcyBpc3N1ZXMg d29ya2luZwotICAgICAgICB3aXRoIGEgbmV3ZXIgcHJvdG9jb2wuCi0gICAgICAgPC9wYXJh PgotICAgICAgPC9saXN0aXRlbT4KLSAgICAgPC92YXJsaXN0ZW50cnk+Ci0KICAgICAgPHZh cmxpc3RlbnRyeSBpZD0ibGlicHEtY29ubmVjdC1rcmJzcnZuYW1lIiB4cmVmbGFiZWw9Imty YnNydm5hbWUiPgogICAgICAgPHRlcm0+PGxpdGVyYWw+a3Jic3J2bmFtZTwvbGl0ZXJhbD48 L3Rlcm0+CiAgICAgICA8bGlzdGl0ZW0+Ci0tIAoyLjQ5LjAKCg== --------------sBcT7gnSnyz3np0yr1E03BRR--