Re: 4.1.4. Special Characters

Subject: Re: 4.1.4. Special Characters

On 28.10.26 Peter Eisentraut wrote:
> I think the section that you are patching is more for roughly mentioning
> all the possible uses of various characters, but it's not the
> authoritative source for what all those characters mean in detail in
> those contexts. Otherwise, this could get out of hand. I would have
> expected to find that for this particular case on the SELECT reference
> page, but it's not mentioned there either. Maybe that page should be
> updated?

Thanks for the review. That makes sense.

The attached v2 drops the change to section 4.1.4 and instead adds a
sentence to the SELECT List section of the SELECT reference page. It
says that neither * nor table_name.* includes system columns, which
must be listed by name, and links to the System Columns section.

The docs build cleanly with make check and make html.

Thanks and Regards,

On Wed, Oct 28, 2026 at 3:32 PM Peter Eisentraut <peter(at)eisentraut(dot)org> wrote:
>
> On 28.10.26 09:15, Arvind Kandpal wrote:
> > The attached patch adds a sentence to the asterisk item in section
> > 4.1.4, saying that system columns are not included in * and must be
> > selected by name, with the suggested example and a link to the System
> > Columns section.
> >
> > I built the docs locally (make check and make html) and the new text
> > and link render fine.
>
> I think the section that you are patching is more for roughly mentioning
> all the possible uses of various characters, but it's not the
> authoritative source for what all those characters mean in detail in
> those contexts. Otherwise, this could get out of hand. I would have
> expected to find that for this particular case on the SELECT reference
> page, but it's not mentioned there either. Maybe that page should be
> updated?
>

--
Arvind Kandpal
Junior Software Engineer
(+91) 9650266413 www.ksolves.com

Years of
listing on