Date: Tue, 4 Aug 2020 14:56:51 +0900
From: Michael Paquier <michael@paquier.xyz>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: osdba <mailtch@163.com>, pgsql-docs@postgresql.org
Subject: Re: Document "59.2. Built-in Operator Classes" have a clerical error?
Message-ID: <20200804055651.GC2091@paquier.xyz>
References: <38d55061.9604.173b32c60ec.Coremail.mailtch@163.com>
 <20200803074904.GO3317@paquier.xyz>
 <2266167.1596453828@sss.pgh.pa.us>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
	protocol="application/pgp-signature"; boundary="sHrvAb52M6C8blB9"
Content-Disposition: inline
In-Reply-To: <2266167.1596453828@sss.pgh.pa.us>
Precedence: bulk


--sHrvAb52M6C8blB9
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Mon, Aug 03, 2020 at 07:23:48AM -0400, Tom Lane wrote:
> So I don't think it's a clerical error, but certainly showing these
> operators this way is none too helpful.  Perhaps including the input types
> in this table (and its siblings elsewhere) would be a good thing.

Ah, thanks.  I did not consider the psql shortcut.  I agree that
including the input types would be a good idea.  But just doing that
may not be enough IMO as the character policy used on our website for
the HTML docs makes that harder to parse.  What if we switched the
third column to have one line per operator with its input type, and
use morerows to show the full set of indexable operators one opclass
is associated with?  Contrary to wait events, those tables don't
change much.  I am wondering as well if we should consider mentioning
\dAo on all those pages, say at the bottom of each table listing the
opclasses.=20
--
Michael

--sHrvAb52M6C8blB9
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEG72nH6vTowiyblFKnvQgOdbyQH0FAl8o+KMACgkQnvQgOdby
QH0BTw//bIzcW83ysrhq2mXo1JyT4c1/2Yv2Nkyy6vn0R+EllUxrBewvJSJGmbfu
kj1VrCjw4wg9QAaGVutn+jaE+sIn0bkhUD8yP5uB4kZJu+WpYuFSdNVnQ+A7T5HA
DQje2ue7OOifXwKIY7MrOErHkhcSoVrrX81eHeP8YwrUjOT27qdlqO/fjpXVt8Pw
KIwN4aNeu83z6HpFXuQMuxeQL67WFUGDb2YqhhlMFvYHOk57NDfvwtEVLmyZHRMe
CW9wdEevsvFnnOSJCdQ7VQMGN90K6w8l09HJxRepc1B4T8F6SzLfiOWVNnZCvNuH
xZJST5mj9WnwVu8IQXTp687PNSrEp26iMFmUhFh9EtsC23w5XXuw3mrsbDpLzRGn
f6Y2JqzqjkDiYKh//WnD5ontCfMICX+DCv3nvbWh0Vl9GdK/TdNGog56PqRwaPhr
7P0cJQ5dQHp7rd+b+5jHjVlc3gqzxqCKzpmL5UoVE+F3EhJegdP3an6I7ct5M+ip
TtVjBhOtmzBTKnyCBhIc/VHoS6IIYM8HnGE3iu5g6nrhyWR/kw/l/uFYeck/K8uF
STqulKi7ETRnizI7VfAN8Fq9zEOYeje5PcH9bHD6aU/XT0qHR1iNIja6ejc8s7cR
VUJNOW1scG1TqW5zWJyprMGK8UCa3UkeHTS8YqlverpkZBA5t+w=
=AAu3
-----END PGP SIGNATURE-----

--sHrvAb52M6C8blB9--