MIME-Version: 1.0
From: Marcos Pegoraro <marcos@f10.com.br>
Date: Wed, 22 Apr 2026 15:59:47 -0300
Message-ID: 
 <CAB-JLwY4izzCHDjS=Xb0KMc7uXbg6JjuMdRA2ri2CqYbeMDMEw@mail.gmail.com>
Subject: Adding an explaining title to Notes on SGML
To: pgsql-hackers <pgsql-hackers@postgresql.org>
Content-Type: multipart/mixed; boundary="000000000000f82f7b06501124b2"
Archived-At: 
 <https://www.postgresql.org/message-id/CAB-JLwY4izzCHDjS%3DXb0KMc7uXbg6JjuMdRA2ri2CqYbeMDMEw%40mail.gmail.com>
Precedence: bulk

--000000000000f82f7b06501124b2
Content-Type: multipart/alternative; boundary="000000000000f82f7a06501124b0"

--000000000000f82f7a06501124b0
Content-Type: text/plain; charset="UTF-8"

I noticed that a "This" was missing when reading the Notes of the
Aggregates page, so I thought... wouldn't it be better if we had a title in
some of the Notes ?
Because in many cases, like this example, you have a huge table and below
it a Notes. But what is this Notes talking about ?
If we had a title specifying exactly what it's about, it would be easier
for the user. In this example, there are dozens of aggregates but Notes
talks only for 2 of them.

There are 300 Notes on SGML files, I did these 2 Notes only to ask you if
this way is fine. And obviously would do them all if you think it's fine.

And additionally the title tag needs to have only
<title>bool_and and bool_or</title>
not
<title>Note on bool_and and bool_or</title>
But this I can change on XSL files to automatically add a title when it
exists.

Regards
Marcos

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

<div dir=3D"ltr"><div class=3D"gmail_default" style=3D"font-family:verdana,=
sans-serif;color:rgb(102,102,102)">I noticed that a &quot;This&quot; was mi=
ssing when reading the Notes of the Aggregates page, so I thought... wouldn=
&#39;t it be better if we had a title in some of the Notes ?=C2=A0</div><di=
v class=3D"gmail_default" style=3D"font-family:verdana,sans-serif;color:rgb=
(102,102,102)">Because in many cases, like this example, you have a huge ta=
ble and below it a Notes. But what is this Notes talking about ?=C2=A0</div=
><div class=3D"gmail_default" style=3D"font-family:verdana,sans-serif;color=
:rgb(102,102,102)">If we had a title specifying exactly what it&#39;s about=
, it would be easier for the user. In this example, there are dozens of agg=
regates but Notes talks only for 2 of them.</div><div class=3D"gmail_defaul=
t" style=3D"font-family:verdana,sans-serif;color:rgb(102,102,102)"><br></di=
v><div class=3D"gmail_default" style=3D"font-family:verdana,sans-serif;colo=
r:rgb(102,102,102)">There are 300 Notes on SGML files, I did these 2 Notes =
only to ask you if this way is fine. And obviously would do them all if you=
 think it&#39;s fine.</div><div class=3D"gmail_default" style=3D"font-famil=
y:verdana,sans-serif;color:rgb(102,102,102)"><br></div><div class=3D"gmail_=
default" style=3D"font-family:verdana,sans-serif;color:rgb(102,102,102)">An=
d additionally=C2=A0the title tag needs to have only=C2=A0<br>&lt;title&gt;=
bool_and and bool_or&lt;/title&gt;</div><div class=3D"gmail_default" style=
=3D"font-family:verdana,sans-serif;color:rgb(102,102,102)">not</div><div cl=
ass=3D"gmail_default" style=3D"font-family:verdana,sans-serif;color:rgb(102=
,102,102)">&lt;title&gt;Note on bool_and and bool_or&lt;/title&gt;</div><di=
v class=3D"gmail_default" style=3D"font-family:verdana,sans-serif;color:rgb=
(102,102,102)">But this I can change on XSL files to automatically add a ti=
tle when it exists.</div><div class=3D"gmail_default" style=3D"font-family:=
verdana,sans-serif;color:rgb(102,102,102)"><br></div><div class=3D"gmail_de=
fault" style=3D"font-family:verdana,sans-serif;color:rgb(102,102,102)">Rega=
rds</div><div class=3D"gmail_default" style=3D"font-family:verdana,sans-ser=
if;color:rgb(102,102,102)">Marcos</div></div>

--000000000000f82f7a06501124b0--

--000000000000f82f7b06501124b2
Content-Type: application/octet-stream;
	name="Adding an explaining title to Notes.diff"
Content-Disposition: attachment;
	filename="Adding an explaining title to Notes.diff"
Content-Transfer-Encoding: base64
Content-ID: <f_moaf1c6b0>
X-Attachment-Id: f_moaf1c6b0

RnJvbSBjNDgxOWYzNzViMDMyZWQxOGIzZDFjMzlhNGQ3ODFhM2VhNzBjMDRhIE1vbiBTZXAgMTcg
MDA6MDA6MDAgMjAwMQpGcm9tOiBQZWdvcmFyb0YxMCA8bWFyY29zQGYxMC5jb20uYnI+CkRhdGU6
IFdlZCwgMjIgQXByIDIwMjYgMTU6Mzc6NDEgLTAzMDAKU3ViamVjdDogW1BBVENIXSBTb21ldGlt
ZXMgd2UgaGF2ZSBhIE5vdGVzIHRhZyBidXQgaXQgZG9lc24ndCBzcGVjaWZ5IGFib3V0CiB3aGF0
IGl0IGlzIHRhbGtpbmcuIFNvIGlmIHdlIGFkZCBhIDx0aXRsZT4gdG8gaXQgdGhlbiB1c2VyIGRv
ZXNuJ3QgbmVlZCB0bwogcmVhZCBhbGwgdGhhdCBOb3RlIHRvIHNlZSBpZiBpdCdzIGltcG9ydGFu
dCBvciBub3QuCgotLS0KIGRvYy9zcmMvc2dtbC9mdW5jL2Z1bmMtYWdncmVnYXRlLnNnbWwgfCA0
ICsrKy0KIDEgZmlsZSBjaGFuZ2VkLCAzIGluc2VydGlvbnMoKyksIDEgZGVsZXRpb24oLSkKCmRp
ZmYgLS1naXQgYS9kb2Mvc3JjL3NnbWwvZnVuYy9mdW5jLWFnZ3JlZ2F0ZS5zZ21sIGIvZG9jL3Ny
Yy9zZ21sL2Z1bmMvZnVuYy1hZ2dyZWdhdGUuc2dtbAppbmRleCA4YjVlYWViMmU5NC4uNmY5MmY3
MzdkNTggMTAwNjQ0Ci0tLSBhL2RvYy9zcmMvc2dtbC9mdW5jL2Z1bmMtYWdncmVnYXRlLnNnbWwK
KysrIGIvZG9jL3NyYy9zZ21sL2Z1bmMvZnVuYy1hZ2dyZWdhdGUuc2dtbApAQCAtNjk2LDYgKzY5
Niw3IEBAIFNFTEVDVCB4bWxhZ2coeCkgRlJPTSAoU0VMRUNUIHggRlJPTSB0ZXN0IE9SREVSIEJZ
IHkgREVTQykgQVMgdGFiOwogICA8L3BhcmE+CiAKICAgPG5vdGU+CisgICAgPHRpdGxlPk5vdGUg
b24gYm9vbF9hbmQgYW5kIGJvb2xfb3I8L3RpdGxlPgogICAgIDxpbmRleHRlcm0+CiAgICAgICA8
cHJpbWFyeT5BTlk8L3ByaW1hcnk+CiAgICAgPC9pbmRleHRlcm0+CkBAIC03MjIsNiArNzIzLDcg
QEAgU0VMRUNUIGIxID0gQU5ZKChTRUxFQ1QgYjIgRlJPTSB0MiAuLi4pKSBGUk9NIHQxIC4uLjsK
ICAgPC9ub3RlPgogCiAgIDxub3RlPgorICAgPHRpdGxlPk5vdGUgb24gY291bnQoKik8L3RpdGxl
PgogICAgPHBhcmE+CiAgICAgVXNlcnMgYWNjdXN0b21lZCB0byB3b3JraW5nIHdpdGggb3RoZXIg
U1FMIGRhdGFiYXNlIG1hbmFnZW1lbnQKICAgICBzeXN0ZW1zIG1pZ2h0IGJlIGRpc2FwcG9pbnRl
ZCBieSB0aGUgcGVyZm9ybWFuY2Ugb2YgdGhlCkBAIC03MzAsNyArNzMyLDcgQEAgU0VMRUNUIGIx
ID0gQU5ZKChTRUxFQ1QgYjIgRlJPTSB0MiAuLi4pKSBGUk9NIHQxIC4uLjsKIDxwcm9ncmFtbGlz
dGluZz4KIFNFTEVDVCBjb3VudCgqKSBGUk9NIHNvbWV0YWJsZTsKIDwvcHJvZ3JhbWxpc3Rpbmc+
Ci0gICAgd2lsbCByZXF1aXJlIGVmZm9ydCBwcm9wb3J0aW9uYWwgdG8gdGhlIHNpemUgb2YgdGhl
IHRhYmxlOgorICAgIFRoaXMgd2lsbCByZXF1aXJlIGVmZm9ydCBwcm9wb3J0aW9uYWwgdG8gdGhl
IHNpemUgb2YgdGhlIHRhYmxlOgogICAgIDxwcm9kdWN0bmFtZT5Qb3N0Z3JlU1FMPC9wcm9kdWN0
bmFtZT4gd2lsbCBuZWVkIHRvIHNjYW4gZWl0aGVyIHRoZQogICAgIGVudGlyZSB0YWJsZSBvciB0
aGUgZW50aXJldHkgb2YgYW4gaW5kZXggdGhhdCBpbmNsdWRlcyBhbGwgcm93cyBpbgogICAgIHRo
ZSB0YWJsZS4KLS0gCjIuNTEuMi53aW5kb3dzLjEKCg==
--000000000000f82f7b06501124b2--