Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-bugs-owner+archive@lists.postgresql.org>)
	id 1mAuln-0005Mw-Tq
	for pgsql-bugs@arkaria.postgresql.org; Tue, 03 Aug 2021 13:47:47 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-bugs-owner+archive@lists.postgresql.org>)
	id 1mAulm-0000Qg-AN
	for pgsql-bugs@arkaria.postgresql.org; Tue, 03 Aug 2021 13:47:46 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1mAulm-0000QY-39
	for pgsql-bugs@lists.postgresql.org; Tue, 03 Aug 2021 13:47:46 +0000
Received: from sss.pgh.pa.us ([66.207.139.130])
	by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1mAulk-0003Ui-1Z
	for pgsql-bugs@lists.postgresql.org; Tue, 03 Aug 2021 13:47:45 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
	by sss.pgh.pa.us (8.15.2/8.15.2) with ESMTP id 173DlfxK1703094;
	Tue, 3 Aug 2021 09:47:41 -0400
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Kyotaro Horiguchi <horikyota.ntt@gmail.com>
cc: david.g.johnston@gmail.com, wstrzalka@gmail.com, pavel.stehule@gmail.com,
        pgsql-bugs@lists.postgresql.org
Subject: Re: psql doesn't show tables duplicated in multiple schemas
In-reply-to: <20210803.151652.174400284784013194.horikyota.ntt@gmail.com>
References: 
 <CAJf-CGtMRx==A=BOcgj03jE4gem_0yan81y2soLCGbeB828+2w@mail.gmail.com>
 <20210803.133502.2007206546027287879.horikyota.ntt@gmail.com>
 <CAKFQuwZZz+iJuA4SgdbkqFq3po8NmcVWubw-zhR9WDuMqP-WGw@mail.gmail.com>
 <20210803.151652.174400284784013194.horikyota.ntt@gmail.com>
Comments: In-reply-to Kyotaro Horiguchi <horikyota.ntt@gmail.com>
	message dated "Tue, 03 Aug 2021 15:16:52 +0900"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <1703092.1627998461.1@sss.pgh.pa.us>
Content-Transfer-Encoding: quoted-printable
Date: Tue, 03 Aug 2021 09:47:41 -0400
Message-ID: <1703093.1627998461@sss.pgh.pa.us>
List-Id: <pgsql-bugs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-bugs@lists.postgresql.org>
List-Owner: <mailto:pgsql-bugs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-bugs>
Archived-At: 
 <https://www.postgresql.org/message-id/1703093.1627998461%40sss.pgh.pa.us>
Precedence: bulk

Kyotaro Horiguchi <horikyota.ntt@gmail.com> writes:
> At Mon, 2 Aug 2021 22:28:33 -0700, "David G. Johnston" <david.g.johnston=
@gmail.com> wrote in =

>> I cannot see rewording this to avoid the use of "visible", but if this =
is a

> Year, I think "visible" is the best word there.  And I'm not sure
> people are actually confused about the word.

The term is actually defined in the psql ref page, in the second para
of the "Patterns" section:

  <para>
   Whenever the <replaceable class=3D"parameter">pattern</replaceable> par=
ameter
   is omitted completely, the <literal>\d</literal> commands display all o=
bjects
   that are visible in the current schema search path &mdash; this is
   equivalent to using <literal>*</literal> as the pattern.
   (An object is said to be <firstterm>visible</firstterm> if its
   containing schema is in the search path and no object of the same
   kind and name appears earlier in the search path. This is equivalent to=
 the
   statement that the object can be referenced by name without explicit
   schema qualification.)
   To see all objects in the database regardless of visibility,
   use <literal>*.*</literal> as the pattern.
  </para>

Maybe this could be rearranged to make the concept more prominent,
but I'm not convinced that we need any really new text.  I definitely
don't want to make duplicative additions to each \d command's text.

			regards, tom lane