public inbox for [email protected]
help / color / mirror / Atom feedFrom: David G. Johnston <[email protected]>
To: Marcos Pegoraro <[email protected]>
Cc: Daniel Gustafsson <[email protected]>
Cc: PostgreSQL Hackers <[email protected]>
Subject: Re: Adding an explaining title to Notes on SGML
Date: Thu, 23 Apr 2026 05:27:08 -0700
Message-ID: <CAKFQuwaDcsiaiBF5eJAM5EPD4TQ3rKV93duvyXV-RprYcp+25w@mail.gmail.com> (raw)
In-Reply-To: <CAB-JLwZUvv0DzA+=5BwXfGSLHXTYiXFyn05kwq-Us3dSzJuZ4g@mail.gmail.com>
References: <CAB-JLwY4izzCHDjS=Xb0KMc7uXbg6JjuMdRA2ri2CqYbeMDMEw@mail.gmail.com>
<[email protected]>
<CAB-JLwZUvv0DzA+=5BwXfGSLHXTYiXFyn05kwq-Us3dSzJuZ4g@mail.gmail.com>
On Thursday, April 23, 2026, Marcos Pegoraro <[email protected]> wrote:
> Em qui., 23 de abr. de 2026 às 04:55, Daniel Gustafsson <[email protected]>
> escreveu:
>
>> Wouldn't it make more sense to refactor to move the information in the
>> note
>> closer to what the note is regarding?
>
>
> Also, a note refers to two items in the table, which are bool_and and
> bool_or, so what do we do ? Repeat the information ?
>
Personally, I’d like to do two things here instead of a note. Use a
footnote, but add entries for any/some to the table and use the description
to say they are not implemented and to use bool_and/bool_or instead, then
anchor the footnote at these entries.
That way, people looking for these SQL standard functions actually find
them where they expect and understand why they are missing. Index entries
wouldn’t hurt.
The note actually seems counter-productive for the typical PostgreSQL user
who doesn’t even know what is in the standard. And an unintuitive place to
look if you know the function names already.
David J.
view thread (8+ messages) latest in thread
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected], [email protected], [email protected]
Subject: Re: Adding an explaining title to Notes on SGML
In-Reply-To: <CAKFQuwaDcsiaiBF5eJAM5EPD4TQ3rKV93duvyXV-RprYcp+25w@mail.gmail.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox