| From: | Chao Li <li(dot)evan(dot)chao(at)gmail(dot)com> |
|---|---|
| To: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
| Cc: | Marcos Pegoraro <marcos(at)f10(dot)com(dot)br>, Álvaro Herrera <alvherre(at)kurilemu(dot)de>, jian he <jian(dot)universality(at)gmail(dot)com>, Jeff Davis <pgsql(at)j-davis(dot)com>, Yugo NAGATA <nagata(at)sraoss(dot)co(dot)jp>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Peter Eisentraut <peter(at)eisentraut(dot)org>, David Rowley <dgrowleyml(at)gmail(dot)com>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org> |
| Subject: | Re: Document NULL |
| Date: | 2026-01-30 03:27:59 |
| Message-ID: | 1DCE7273-CC25-4179-B603-C52C3F906FA5@gmail.com |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
> On Jan 30, 2026, at 10:16, David G. Johnston <david(dot)g(dot)johnston(at)gmail(dot)com> wrote:
>
> On Thu, Jan 29, 2026 at 2:18 PM David G. Johnston <david(dot)g(dot)johnston(at)gmail(dot)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(at)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/
| From | Date | Subject | |
|---|---|---|---|
| Next Message | David G. Johnston | 2026-01-30 03:43:45 | Re: Document NULL |
| Previous Message | Chao Li | 2026-01-30 03:15:51 | tablecmds: Deadlock caused by Attach Partition |