Adding an explaining title to Notes on SGML

From: Marcos Pegoraro <marcos(at)f10(dot)com(dot)br>
To: pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Adding an explaining title to Notes on SGML
Date: 2026-04-22 18:59:47
Message-ID: CAB-JLwY4izzCHDjS=Xb0KMc7uXbg6JjuMdRA2ri2CqYbeMDMEw@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

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

Attachment Content-Type Size
Adding an explaining title to Notes.diff application/octet-stream 1.6 KB

Browse pgsql-hackers by date

  From Date Subject
Next Message Andres Freund 2026-04-22 19:05:33 Re: Startup process deadlock: WaitForProcSignalBarriers vs aux process
Previous Message Paul A Jungwirth 2026-04-22 18:37:22 Re: Inconsistent trigger behavior between two temporal leftovers