MIME-Version: 1.0
In-Reply-To: 
 <CAB-JLwZUvv0DzA+=5BwXfGSLHXTYiXFyn05kwq-Us3dSzJuZ4g@mail.gmail.com>
References: 
 <CAB-JLwY4izzCHDjS=Xb0KMc7uXbg6JjuMdRA2ri2CqYbeMDMEw@mail.gmail.com>
 <778F991A-3BF8-4618-8F2E-3C503063F650@yesql.se>
 <CAB-JLwZUvv0DzA+=5BwXfGSLHXTYiXFyn05kwq-Us3dSzJuZ4g@mail.gmail.com>
From: "David G. Johnston" <david.g.johnston@gmail.com>
Date: Thu, 23 Apr 2026 05:27:08 -0700
Message-ID: 
 <CAKFQuwaDcsiaiBF5eJAM5EPD4TQ3rKV93duvyXV-RprYcp+25w@mail.gmail.com>
Subject: Re: Adding an explaining title to Notes on SGML
To: Marcos Pegoraro <marcos@f10.com.br>
Cc: Daniel Gustafsson <daniel@yesql.se>,
 PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Content-Type: multipart/alternative; boundary="00000000000064c0f406501fc475"
Archived-At: 
 <https://www.postgresql.org/message-id/CAKFQuwaDcsiaiBF5eJAM5EPD4TQ3rKV93duvyXV-RprYcp%2B25w%40mail.gmail.com>
Precedence: bulk

--00000000000064c0f406501fc475
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Thursday, April 23, 2026, Marcos Pegoraro <marcos@f10.com.br> wrote:

> Em qui., 23 de abr. de 2026 =C3=A0s 04:55, Daniel Gustafsson <daniel@yesq=
l.se>
> 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=E2=80=99d 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=E2=80=99t hurt.

The note actually seems counter-productive for the typical PostgreSQL user
who doesn=E2=80=99t even know what is in the standard.  And an unintuitive =
place to
look if you know the function names already.

David J.

--00000000000064c0f406501fc475
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Thursday, April 23, 2026, Marcos Pegoraro &lt;<a href=3D"mailto:marcos@f=
10.com.br">marcos@f10.com.br</a>&gt; wrote:<br><blockquote class=3D"gmail_q=
uote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1e=
x"><div dir=3D"ltr"><div dir=3D"ltr"><div>Em qui., 23 de abr. de 2026 =C3=
=A0s 04:55, Daniel Gustafsson &lt;<a href=3D"mailto:daniel@yesql.se" target=
=3D"_blank">daniel@yesql.se</a>&gt; escreveu:</div></div><div class=3D"gmai=
l_quote"><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8e=
x;border-left:1px solid rgb(204,204,204);padding-left:1ex">
Wouldn&#39;t it make more sense to refactor to move the information in the =
note<br>
closer to what the note is regarding?</blockquote><div><br></div><div class=
=3D"gmail_default" style=3D"font-family:verdana,sans-serif;color:rgb(102,10=
2,102)">Also, a note refers to two items in the table, which are bool_and a=
nd bool_or, so what do we do ? Repeat the information ?<br></div></div></di=
v></blockquote><div><br></div><div>Personally, I=E2=80=99d like to do two t=
hings here instead of a note.=C2=A0 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 entr=
ies.</div><div><br></div><div>That way, people looking for these SQL standa=
rd functions actually find them where they expect and understand why they a=
re missing.=C2=A0 Index entries wouldn=E2=80=99t hurt.</div><div><br></div>=
<div>The note actually seems counter-productive for the typical PostgreSQL =
user who doesn=E2=80=99t even know what is in the standard.=C2=A0 And an un=
intuitive place to look if you know the function names already.</div><div><=
br></div><div>David J.</div><div><br></div>

--00000000000064c0f406501fc475--