Re: Document NULL

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 05:30:44
Message-ID: ABB21B5C-C38C-4DC8-A7B9-FCE741BEFC3B@gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

> On Jan 30, 2026, at 11:43, David G. Johnston <david(dot)g(dot)johnston(at)gmail(dot)com> wrote:
>
> On Thu, Jan 29, 2026 at 8:28 PM Chao Li <li(dot)evan(dot)chao(at)gmail(dot)com> wrote:
>
> 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
>
>
> I had actually caught that failure to use an &lt; entity, but missed doing a git add....
>
> Anyway, v12 with the approach I prefer...using CDATA to avoid having to perform entity substitution.
>
> David J.
> <v12-0001-doc-Provide-an-overview-of-NULL-handling.patch><v12-0002-Update-all-examples.patch>

V12 passed the building.

My only comment on v12 is:
```
- Boolean (true/false) results.
+ <link linkend="nullvalues">three-valued</link> boolean typed
```

I think it’s better to use capital “B” for “boolean”. See [1].

[1] https://postgr.es/m/2508109.1769050728@sss.pgh.pa.us

Best regards,
--
Chao Li (Evan)
HighGo Software Co., Ltd.
https://www.highgo.com/

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Corey Huinker 2026-01-30 05:34:09 Re: Optional skipping of unchanged relations during ANALYZE?
Previous Message Corey Huinker 2026-01-30 05:28:03 Re: Optional skipping of unchanged relations during ANALYZE?