From: Chao Li <li.evan.chao@gmail.com>
To: David G. Johnston <david.g.johnston@gmail.com>
Cc: Marcos Pegoraro <marcos@f10.com.br>
Cc: Álvaro Herrera <alvherre@kurilemu.de>
Cc: jian he <jian.universality@gmail.com>
Cc: Jeff Davis <pgsql@j-davis.com>
Cc: Yugo NAGATA <nagata@sraoss.co.jp>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Peter Eisentraut <peter@eisentraut.org>
Cc: David Rowley <dgrowleyml@gmail.com>
Cc: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Subject: Re: Document NULL
Date: Fri, 30 Jan 2026 11:27:59 +0800
Message-ID: <1DCE7273-CC25-4179-B603-C52C3F906FA5@gmail.com> (raw)
In-Reply-To: <CAKFQuwYBnoOWgA+Zaeiduwb_1fsZ_bECtk8tGqC2NYgPfYhVLQ@mail.gmail.com>
References: <CAKFQuwbnFCr+31wpcpzac-uDTCoRSuU6Ka-7YPYw5ZSHR6kqZA@mail.gmail.com>
<202511111530.xp4avso6b4pb@alvherre.pgsql>
<CAB-JLwbjzGL-Jtb-AuTrgBkVWKH8LUXDu3wxkLyOLHXUH4UYmg@mail.gmail.com>
<CAKFQuwaULsfcG=9JmuGO7VXvTOH8hxsuGhwq2zASAYi48SmfRA@mail.gmail.com>
<CAB-JLwbJz06-H-F2nYBKsGaqNB9aDhT4on-Anhw40Tq-9YoTGg@mail.gmail.com>
<CAB-JLwYtaKd_QEfw_eV7y33V+C1AzWDW=g=c4THujGi04cF3wg@mail.gmail.com>
<CAKFQuwYN9rG6uD64BqaVSdv+iL_Nudk7qbQ+Z2reiRa7CaodHQ@mail.gmail.com>
<CAKFQuwYBnoOWgA+Zaeiduwb_1fsZ_bECtk8tGqC2NYgPfYhVLQ@mail.gmail.com>
> On Jan 30, 2026, at 10:16, David G. Johnston <david.g.johnston@gmail.com> wrote:
>
> On Thu, Jan 29, 2026 at 2:18 PM David G. Johnston <david.g.johnston@gmail.com> wrote:
> Thank you for the review. My bad on these. I'm working through all the examples again to get them cleaned up properly.
>
> v11 with the examples work as a separate patch over v10 to be squashed.
>
> Tried to be consistent on "Title Case" within headers other than a few where the all-caps operator really made the most sense.
> Got NULL for SQL null literals throughout and Null for psql display of the same.
> Removed abbreviations in titles generally. Re-worked a couple of the more complex ones.
>
> Decided to leave my agent instructions in place (xml-styled comment). The flow actually worked pretty well, though it's nuanced enough to be wary of false-negatives. Hopefully I got them all.
>
> David J.
>
> <v11-0002-Update-all-examples.patch><v11-0001-doc-Provide-an-overview-of-NULL-handling.patch>
I failed to build v11:
```
chaol@ChaodeMacBook-Air sgml % make html
/usr/bin/xmllint --nonet --path . --path . --output postgres-full.xml --noent --valid postgres.sgml
nullvalues.sgml:735: parser error : StartTag: invalid element name
s | t | Stored = Stored | Stored < Constructor | Stored = Constructor
^
nullvalues.sgml:1206: parser error : chunk is not well balanced
^
ddl.sgml:171: parser error : Entity 'nullvalues' failed to parse
&nullvalues;
^
ddl.sgml:5871: parser error : chunk is not well balanced
^
postgres.sgml:105: parser error : Entity 'ddl' failed to parse
&ddl;
^
make: *** [postgres-full.xml] Error 1
```
Best regards,
--
Chao Li (Evan)
HighGo Software Co., Ltd.
https://www.highgo.com/
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: pgsql-hackers@postgresql.org
Cc: li.evan.chao@gmail.com, david.g.johnston@gmail.com, marcos@f10.com.br, alvherre@kurilemu.de, jian.universality@gmail.com, pgsql@j-davis.com, nagata@sraoss.co.jp, tgl@sss.pgh.pa.us, peter@eisentraut.org, dgrowleyml@gmail.com, pgsql-hackers@lists.postgresql.org
Subject: Re: Document NULL
In-Reply-To: <1DCE7273-CC25-4179-B603-C52C3F906FA5@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 DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox