Re: TLS docs fixes for <programlisting>

On Wed, May 13, 2020 at 11:07:44PM +0200, Daniel Gustafsson wrote:
> While working with TLS I noticed that the password callback definition had an
> extra newline in the programlisting in the docs. Since the <programlisting>
> has been indented with the textblock, the newline comes from whitespace being
> significant. The attached 0001 fixes by instead anchoring <programlisting> on
> column zero like how most of the docs do it. Grepping around I found one more
> instance of the same pattern which is also included.

Indeed, I can see the difference. In what I spotted after applying
0001, you are patching the one in libpq.sgml as of 0002 but in a
different, correct, way, and I have spotted three more inconsistencies
within doc/src/sgml/datatype.sgml in the zone for timestamps.

> The "Enter PEM pass phrase" prompt was referred to in one place with <literal>
> and one with <programlisting>, the 0002 settles on using <literal> for both
> since IMO that makes the docs more readable. While there, it also fixes the
> spelling of "pass phrase" from the two variations we had (of which none was the
> correct one from src/backend/libpq/be-secure-openssl.c as well as the OpenSSL
> file crypto/pem/pem_lib.c).

Yeah, good catch. Let's fix that.

With everything I found on top of your stuff, I finish with the
attached. Does it look fine to you?
--
Michael