Unclear wording - PG Doc comments form

agora inbox for pgsql-docs@postgresql.org  
help / color / mirror / Atom feed

From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: postgresql@mackler.email
Subject: Unclear wording
Date: Fri, 11 Jul 2025 16:12:11 +0000
Message-ID: <175225033172.858621.3992434425623506886@wrigleys.postgresql.org> (raw)

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/17/ddl-schemas.html
Description:

In §5.10.3 these two sentences seem inconsistent:

> When objects are referenced in any other context without schema
qualification...the search path is traversed until a matching object is
found. Therefore, in the default configuration, any unqualified access again
can only refer to the public schema.

Either unqualified access can refer to any schema in the search path,
because the search path is traversed until a matching object is found, or
else unqualified access can only refer to the public schema because the
search path will not be traversed looking in other schemas for a matching
object, but both of those possibilities conflict with one or the other of
the sentences quoted from the manual.

Obviously I'm missing something; I don't know which of the two sentences
quoted from the manual to believe, or if I am to understand both are true,
what I am misunderstanding about their meaning.

view thread (8+ messages)  latest in thread

Message-ID: <175225033172.858621.3992434425623506886@wrigleys.postgresql.org>
Permalink:  ../175225033172.858621.3992434425623506886@wrigleys.postgresql.org/
Also on:    postgresql.org/message-id/175225033172.858621.3992434425623506886@wrigleys.postgresql.org

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: noreply@postgresql.org, pgsql-docs@lists.postgresql.org, postgresql@mackler.email
  Subject: Re: Unclear wording
  In-Reply-To: <175225033172.858621.3992434425623506886@wrigleys.postgresql.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox