Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1ghFsT-0007yA-4m for pgsql-docs@arkaria.postgresql.org; Wed, 09 Jan 2019 15:34:45 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1ghFsR-0007DV-C6 for pgsql-docs@arkaria.postgresql.org; Wed, 09 Jan 2019 15:34:43 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1ghFsR-0007DO-2Y for pgsql-docs@lists.postgresql.org; Wed, 09 Jan 2019 15:34:43 +0000 Received: from meldrar.postgresql.org ([2a02:c0:301:0:ffff::31]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1ghFsM-00038j-HQ for pgsql-docs@lists.postgresql.org; Wed, 09 Jan 2019 15:34:41 +0000 Received: from [63.118.15.50] (helo=Ph33r-Retina.local) by meldrar.postgresql.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1ghFsI-0007mN-GQ; Wed, 09 Jan 2019 15:34:37 +0000 Subject: Re: protocol-message-formats <- display format From: "Jonathan S. Katz" To: leobiwankenobi@gmail.com, pgsql-docs@lists.postgresql.org Cc: Sarah Schnurr References: <154697599467.22752.11471967510249028725@wrigleys.postgresql.org> <1ec4a818-d66d-9bd9-1d44-003f707f06d6@postgresql.org> Openpgp: preference=signencrypt Autocrypt: addr=jkatz@postgresql.org; keydata= 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 FmEC Message-ID: Date: Wed, 9 Jan 2019 10:34:32 -0500 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.12; rv:60.0) Gecko/20100101 Thunderbird/60.4.0 MIME-Version: 1.0 In-Reply-To: <1ec4a818-d66d-9bd9-1d44-003f707f06d6@postgresql.org> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="yFp7dEfPJ2019iMF12WrebEUT0vCo8Msu" X-Host-Lookup-Failed: Reverse DNS lookup failed for 63.118.15.50 (failed) List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --yFp7dEfPJ2019iMF12WrebEUT0vCo8Msu Content-Type: multipart/mixed; boundary="YN3QmD6OVlbeOtRuScXJ8Gu2rmQr5F1JI"; protected-headers="v1" From: "Jonathan S. Katz" To: leobiwankenobi@gmail.com, pgsql-docs@lists.postgresql.org Cc: Sarah Schnurr Message-ID: Subject: Re: protocol-message-formats <- display format References: <154697599467.22752.11471967510249028725@wrigleys.postgresql.org> <1ec4a818-d66d-9bd9-1d44-003f707f06d6@postgresql.org> In-Reply-To: <1ec4a818-d66d-9bd9-1d44-003f707f06d6@postgresql.org> --YN3QmD6OVlbeOtRuScXJ8Gu2rmQr5F1JI Content-Type: multipart/mixed; boundary="------------9A7CFF37B8FCBD13F56AEBF7" Content-Language: en-US This is a multi-part message in MIME format. --------------9A7CFF37B8FCBD13F56AEBF7 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On 1/9/19 10:13 AM, Jonathan S. Katz wrote: > On 1/8/19 2:33 PM, PG Doc comments form wrote: >> The following documentation comment has been logged on the website: >> >> Page: https://www.postgresql.org/docs/11/protocol-message-formats.html= >> Description: >> >> Hi, >> >> It would improve the readability if we add further tabulation to the >> description of each message. >> Also, make the message title bold to visually distinguish it from the >> description. >> >> I would gladly modify the css to make this happen. >=20 > Looking at a version[1] before the the redesign, it appears there was > further indentation, so yes, this should be added back in. Attached is a patch to correct this. I tested several pages that are affected by the "VARIABLELIST" style in multiple versions, and it appears to be an overall improvement. I will apply to pgweb shortly. Thanks, Jonathan --------------9A7CFF37B8FCBD13F56AEBF7 Content-Type: text/plain; charset=UTF-8; x-mac-type="0"; x-mac-creator="0"; name="0001-Add-further-indentation-to-variable-lists-to-disting.patch" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename*0="0001-Add-further-indentation-to-variable-lists-to-disting.pa"; filename*1="tch" RnJvbSA3OTI1Mzg2NmUzZmY5OTA0N2M2YmM2ZTRiNzlkYTZlY2JiNDgyM2M4IE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiAiSm9uYXRoYW4gUy4gS2F0eiIgPGpvbmF0aGFuLmth dHpAZXhjb3ZlbnR1cmVzLmNvbT4KRGF0ZTogV2VkLCA5IEphbiAyMDE5IDEwOjMxOjQ2IC0w NTAwClN1YmplY3Q6IFtQQVRDSF0gQWRkIGZ1cnRoZXIgaW5kZW50YXRpb24gdG8gdmFyaWFi bGUgbGlzdHMgdG8gZGlzdGluZ3Vpc2gKIGdyb3Vwcy4KClRoaXMgd2FzIGFuIHJlZ3Jlc3Np b24gaW50cm9kdWNlZCBieSB0aGUgbmV3IHN0eWxlcyB0aGF0IGFmZmVjdHMKcmVhZGFiaWxp dHkgb2YgbmVzdGVkIHZhcmlhYmxlcyBsaXN0cyAoZS5nLiBvbiB0aGUgbWVzc2FnZSBwcm90 b2NvbApwYWdlKS4gVGhpcyBicmluZ3MgdGhlIGxvb2sgbW9yZSBpbiBsaW5lIHdpdGggdGhl IHByZXZpb3VzIGRvY3VtZW50YXRpb24Kc3R5bGVzIGFuZCBzaG91bGQgaGVscCB3aXRoIHJl YWRhYmlsaXR5LgotLS0KIG1lZGlhL2Nzcy9tYWluLmNzcyB8IDE1ICsrKysrKysrKysrKysr KwogMSBmaWxlIGNoYW5nZWQsIDE1IGluc2VydGlvbnMoKykKCmRpZmYgLS1naXQgYS9tZWRp YS9jc3MvbWFpbi5jc3MgYi9tZWRpYS9jc3MvbWFpbi5jc3MKaW5kZXggN2IxMTQ1Ni4uYzBj ZjE2ZCAxMDA2NDQKLS0tIGEvbWVkaWEvY3NzL21haW4uY3NzCisrKyBiL21lZGlhL2Nzcy9t YWluLmNzcwpAQCAtOTQxLDYgKzk0MSwyMSBAQCBjb2RlLAogICAgIGZvbnQtd2VpZ2h0OiAz MDA7CiB9CiAKKyNkb2NDb250ZW50IC5WQVJJQUJMRUxJU1QgZHQsCisjZG9jQ29udGVudCAu dmFyaWFibGVsaXN0IGR0IHsKKyAgICBmb250LWZhbWlseTogbW9ub3NwYWNlOworICAgIGZv bnQtd2VpZ2h0OiAzMDA7Cit9CisKKyNkb2NDb250ZW50IC52YXJpYWJsZWxpc3QgZGQgewor ICAgIG1hcmdpbi10b3A6IDFyZW07Cit9CisKKyNkb2NDb250ZW50IC5WQVJJQUJMRUxJU1Qg ZGQsCisjZG9jQ29udGVudCAudmFyaWFibGVsaXN0IGRkIHsKKyAgICBtYXJnaW4taW5saW5l LXN0YXJ0OiAycmVtOworfQorCiAjZG9jQ29udGVudCB1bC5pdGVtaXplZGxpc3QgewogICAg IG1hcmdpbi1sZWZ0OiAyLjVyZW07CiB9Ci0tIAoyLjE0LjMgKEFwcGxlIEdpdC05OCkKCg== --------------9A7CFF37B8FCBD13F56AEBF7-- --YN3QmD6OVlbeOtRuScXJ8Gu2rmQr5F1JI-- --yFp7dEfPJ2019iMF12WrebEUT0vCo8Msu Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEE+oS2la8r95ogZD/x8QSccp8cZScFAlw2FIgACgkQ8QSccp8c ZSfRrQ//Zpe68jETDonlz3p6sD2TNUZfhYjjTXpPtNcHEiYXBfvlfEd1qtXcgzxV PkTBnRlLoeTCm4r57HJQR2HgnGnB272N7KGi0k+zbYQVhNQTjy0Wj83BVuFSq389 ee6c4tdDw8iZo5vT1ubyNHXsC5b9HOroN25BWLXlB4pICCgxx0dK2uJhpwSh28bQ QxvTbHjrJOC40FhJnPGnVG3sJI4Wbp9C8O3W8AIWcUEUgajYKJOP9MtLRIiMSiZv sHtlxEj7FAFN3RfSlu1wdj8vPQMsYfHy+NVhNeeYSZYtp2Rcs0U7aV+RUe79O7q8 Cnd8U8QUJa5uZGYCrcV7Zlbdot2P9PbV6jCb91Jgl63vkGEm2d3cMk9j60HtLIqU op18WPHTp0CL5yEOGJtXS6mK2sKH7und9B60oZ4SIMgPorpbN6n2YmnqNn1ybM/G G1mQsE4ibv8X1cvBl+h3vTtjcE9ywjFexeGC4svEa7LpGGzaA6pCZ7ejg5n/I7jH 9FbtU7dtOvZaYd8LfNWRjyYJJmLelqzH7I06ur89HtpVdco7yDP07HEdwBbuIXs0 3BHer26i8HfsKgLNxLhNPJBrXkloHqqePt4QxpVWmmfUGb156zNaFkGNrtM6tTBB Azjh0dhi721OzxVGWFiX6bgl/vqAJByXJ0Ehl+EZlE9YO5VWu+c= =JJOJ -----END PGP SIGNATURE----- --yFp7dEfPJ2019iMF12WrebEUT0vCo8Msu--