Re: 4.1.4. Special Characters

From: Matemática A3K <matematica(dot)a3k(at)gmail(dot)com>
To: Arvind Kandpal <arvind(dot)kandpal(at)ksolves(dot)com>
Cc: peter(at)eisentraut(dot)org, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: 4.1.4. Special Characters
Date: 2026-11-03 03:35:50
Message-ID: CA+FDnhJuY4Aqf5K_svmV0gqpMumK7owAQv0xv3joZKuiZk_-fA@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

I think if you want to go in that direction, you should refactor saying
something like "* is the shorthand for all the user-defined columns (see
system columns)". What do you think?

On Mon, Nov 2, 2026 at 4:55 AM Arvind Kandpal <arvind(dot)kandpal(at)ksolves(dot)com>
wrote:

> Hi Peter,
>
> Following up on the v2 patch I sent to the list on Oct 28, based on your
> suggestion to update the SELECT reference page instead of section 4.1.4.
> I'm attaching it again here for convenience.
>
> When you have time, could you take a look and let me know if it looks good
> or needs any changes?
>
> Thanks and Regards,
>
> On Wed, Oct 28, 2026 at 3:43 PM Arvind Kandpal <arvind(dot)kandpal(at)ksolves(dot)com>
> wrote:
>
>> 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 <+91%2096502%2066413> www.ksolves.com
>>
>> Years of
>> listing on
>>
>
>
> --
> [image: Arvind Kandpal]
> Arvind Kandpal [image: LinkedIn]
> <https://www.linkedin.com/in/arvind-kandpal-4635b1229/>
> Junior Software Engineer
> [image: Phone] (+91) 9650266413 <(+91)+9650266413> [image: Website]
> www.ksolves.com
> [image: Great Place to Work] [image: CMMI Level 3] [image: ISO] [image:
> Salesforce Summit Partner] [image: Odoo Gold Partner] [image: Figma
> Partner]
> [image: Ksolves - AI First, Always]
> [image: Celebrating]
> [image: 6] Years of
> listing on
> [image: Indian Stock Exchange]
>
>
>

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Matemática A3K 2026-11-03 03:46:44 Re: Documented parameter names differ from callable proargnames for several built-ins
Previous Message Fujii Masao 2026-11-02 17:00:51 Re: postmaster.pid also contains shared memory key