Unclear wording

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: postgresql(at)mackler(dot)email
Subject: Unclear wording
Date: 2025-07-11 16:12:11
Message-ID: 175225033172.858621.3992434425623506886@wrigleys.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

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.

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Daniel Gustafsson 2025-07-11 22:18:18 Re: Missing File weather.txt
Previous Message PG Doc comments form 2025-07-11 10:34:28 please define 'statement' in the glossary