Re: Document NULL - Mailing list pgsql-hackers

From Peter Eisentraut
Subject Re: Document NULL
Date
Msg-id 6c11f5a2-478c-42af-9208-e82bb710e78a@eisentraut.org
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 02.05.24 17:23, David G. Johnston wrote:
> Version 2 attached.  Still a draft, focused on topic picking and overall 
> structure.  Examples and links planned plus the usual semantic markup stuff.
> 
> I chose to add a new sect1 in the user guide (The SQL Language) chapter, 
> "Data".

Please, let's not.

A stylistic note: "null" is an adjective.  You can talk about a "null 
value" or a value "is null".  These are lower-cased (or maybe 
title-cased).  You can use upper-case when referring to SQL syntax 
elements (in which case also tag it with something like <literal>), and 
also to the C-language symbol (tagged with <symbol>).  We had recently 
cleaned this up, so I think the rest of the documentation should be 
pretty consistent about this.



pgsql-hackers by date:

Previous
From: Jacob Champion
Date:
Subject: Re: [PATCH] json_lex_string: don't overread on bad UTF8
Next
From: Peter Eisentraut
Date:
Subject: Re: Support LIKE with nondeterministic collations