Document strange jsonb sort order for empty top level arrays
authorAndrew Dunstan <andrew@dunslane.net>
Fri, 3 Jan 2025 14:23:46 +0000 (09:23 -0500)
committerAndrew Dunstan <andrew@dunslane.net>
Fri, 3 Jan 2025 15:29:03 +0000 (10:29 -0500)
commit653729ce0ec1c38b444740637896d6ec706ef13a
tree249985bbbdc304a32b90fc0df668c4e8b21aaea9
parenta1a9120c797d689be1dafd6fac8d956e3f667ba6
Document strange jsonb sort order for empty top level arrays

Slightly faulty logic in the original jsonb code (commit d9134d0a355)
results in an empty top level array sorting less than a json null. We
can't change the sort order now since it would affect btree indexes over
jsonb, so document the anomaly.

Backpatch to all live branches (13 .. 17)

In master, also add a code comment noting the anomaly.

Reported-by: Yan Chengpen
Reviewed-by: Jian He
Discussion: http://postgr.es/m/OSBPR01MB45199DD8DA2D1CECD50518188E272@OSBPR01MB4519.jpnprd01.prod.outlook.com
doc/src/sgml/json.sgml