Re: SSL/TLS instead of SSL in docs
Michael Paquier <michael@paquier.xyz>
From: Michael Paquier <michael@paquier.xyz>
To: Daniel Gustafsson <daniel@yesql.se>
Cc: Bruce Momjian <bruce@momjian.us>, Tom Lane <tgl@sss.pgh.pa.us>, Magnus Hagander <magnus@hagander.net>, Andrew Dunstan <andrew.dunstan@2ndquadrant.com>, Jeff Davis <pgsql@j-davis.com>, PostgreSQL Developers <pgsql-hackers@lists.postgresql.org>
Date: 2021-06-18T05:37:32Z
Lists: pgsql-hackers
On Tue, Jun 15, 2021 at 03:59:18PM +0200, Daniel Gustafsson wrote: > While in there I added IMO missing items to the glossary and acronyms sections > as well as fixed up markup around OpenSSL. > > This only deals with docs, but if this is deemed interesting then userfacing > messages in the code should use SSL/TLS as well of course. + <term><acronym>SNI</acronym></term> + <listitem> + <para> + <link linkend="libpq-connect-sslsni">Server Name Indication</link> + </para> + </listitem> It looks inconsistent to me to point to the libpq documentation to get the details about SNI. Wouldn't is be better to have an item in the glossary that refers to the bits of RFC 6066, and remove the reference of the RPC from the libpq page? - to present a valid (trusted) SSL certificate, while + to present a valid (trusted) <acronym>SSL</acronym>/<acronym>TLS</acronym> certificate, while This style with two acronyms for what we want to be one thing is heavy. Could it be better to just have one single acronym called SSL/TLS that references both parts? Patch 0003, for the <productname> markups with OpenSSL, included one SSL/TLS entry. -- Michael
Commits
-
doc: Clarify when SSL actually means TLS
- 860ea46ba7be 15.0 landed
-
doc: Add acronyms for MITM and SNI
- 15ff5401d171 14.0 landed
-
doc: Apply markup <productname> to OpenSSL more consistently
- f80979f659d3 14.0 landed
-
Introduce --with-ssl={openssl} as a configure option
- fe61df7f82aa 14.0 cited