Re: Adding an explaining title to Notes on SGML - Mailing list pgsql-hackers

From David G. Johnston
Subject Re: Adding an explaining title to Notes on SGML
Date
Msg-id CAKFQuwaDcsiaiBF5eJAM5EPD4TQ3rKV93duvyXV-RprYcp+25w@mail.gmail.com
Whole thread
In response to Re: Adding an explaining title to Notes on SGML  (Marcos Pegoraro <marcos@f10.com.br>)
Responses Re: Adding an explaining title to Notes on SGML
List pgsql-hackers
On Thursday, April 23, 2026, Marcos Pegoraro <marcos@f10.com.br> wrote:
Em qui., 23 de abr. de 2026 às 04:55, Daniel Gustafsson <daniel@yesql.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’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.

pgsql-hackers by date:

Previous
From: Marcos Pegoraro
Date:
Subject: Re: Adding an explaining title to Notes on SGML
Next
From: SCHOEMANS Maxime
Date:
Subject: Re: Implement missing join selectivity estimation for range types