| 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 |
| 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 |