Re: 7.2.1. The FROM Clause

From: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: jochen(dot)bandhauer(at)gmx(dot)net, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: 7.2.1. The FROM Clause
Date: 2026-06-15 06:39:05
Message-ID: b6edba3f2eea272a5b663935544e89e8a15221ac.camel@cybertec.at
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Sun, 2026-06-14 at 16:40 -0400, Tom Lane wrote:
> Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at> writes:
> > To be honest, I only learned about the syntax
> > "tab *" a few days ago. Digging through the history, this syntax has been
> > obsolete since 2000. I think we could remove both the paragraph that confuses
> > you and the asterisk from the syntax diagram.
>
> I think we've discussed that before, and concluded that removing the
> docs would be a disservice to users who are trying to read old code
> that does this and don't know what it means. Maybe that argument
> is too weak now to justify keeping the docs, but I'm unsure.
> I'd be inclined to just rephrase this sentence in hopes of making
> it less ambiguous.

Fine by me; here is a patch.

I could not resist the temptation to remove the "now always" in
"searching descendant tables is now always the default". That sounds
too much like this was a recent change.

Yours,
Laurenz Albe

Attachment Content-Type Size
v1-0001-Reword-doc-for-asterisk-after-table-names.patch text/x-patch 1.8 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2026-06-15 15:05:52 Re: 7.2.1. The FROM Clause
Previous Message Tom Lane 2026-06-14 20:40:34 Re: 7.2.1. The FROM Clause