--- doc/src/sgml/func.sgml.orig 2023-03-29 12:45:45.013598284 +0200 +++ doc/src/sgml/func.sgml 2023-03-29 14:24:41.966456134 +0200 @@ -15830,10 +15830,10 @@ Constructs a JSON array from either a series of value_expression parameters or from the results of query_expression, - which must be a SELECT query returning a single column. If - ABSENT ON NULL is specified, NULL values are ignored. - This is always the case if a - query_expression is used. + which must be a SELECT query returning a single column. + If the input is a series of value_expressions, NULL values are omitted + unless NULL ON NULL is specified. If a query_expression is used NULLs + are always ignored. json_array(1,true,json '{"a":null}') @@ -20310,13 +20310,14 @@ ORDER BY sort_expression { NULL | ABSENT } ON NULL RETURNING data_type FORMAT JSON ENCODING UTF8 ) + json Behaves in the same way as json_array but as an aggregate function so it only takes one value_expression parameter. - If ABSENT ON NULL is specified, any NULL - values are omitted. + NULL values are omitted unless NULL ON NULL + is specified. If ORDER BY is specified, the elements will appear in the array in that order rather than in the input order.