Re: Document NULL - Mailing list pgsql-hackers

From Chao Li
Subject Re: Document NULL
Date
Msg-id 1DCE7273-CC25-4179-B603-C52C3F906FA5@gmail.com
Whole thread Raw
In response to Re: Document NULL  ("David G. Johnston" <david.g.johnston@gmail.com>)
Responses Re: Document NULL
List pgsql-hackers

> 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
mostsense. 
> 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'snuanced 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/







pgsql-hackers by date:

Previous
From: Chao Li
Date:
Subject: tablecmds: Deadlock caused by Attach Partition
Next
From: "David G. Johnston"
Date:
Subject: Re: Document NULL