SQL/JSON: Various improvements to SQL/JSON query function docs 1. Remove the keyword SELECT from the examples to be consistent with the examples of other JSON-related functions listed on the same page.
2. Add <synopsis> tags around the functions' syntax definition 3. Capitalize function names in the syntax synopsis and the examples 4. Use <itemizedlist> lists for dividing the descriptions of individual functions into bullet points 5. Significantly rewrite the description of wrapper clauses of JSON_QUERY 6. Significantly rewrite the descriptions of ON ERROR / EMPTY clauses of JSON_QUERY() and JSON_VALUE() functions 7. Add a note about how JSON_VALUE() and JSON_QUERY() differ when returning a JSON null result 8. Move the description of the PASSING clause from the descriptions of individual functions into the top paragraph And other miscellaneous text improvements, typo fixes. Suggested-by: Thom Brown <t...@linux.com> Suggested-by: David G. Johnston <david.g.johns...@gmail.com> Reviewed-by: Jian He <jian.universal...@gmail.com> Reviewed-by: Erik Rijkers <e...@xs4all.nl> Discussion: https://postgr.es/m/CAA-aLv7Dfy9BMrhUZ1skcg=odqyswkzobs7xidxdotjnf0e...@mail.gmail.com Discussion: https://postgr.es/m/cakfquwznxnhupk44zdf7z8qzec1aof10aa9twvbu5cmheke...@mail.gmail.com Branch ------ master Details ------- https://git.postgresql.org/pg/commitdiff/42de72fa7b80645347cd7ef3fbb6b0b58d0870f2 Modified Files -------------- doc/src/sgml/func.sgml | 225 ++++++++++++++++++++++++++++++++----------------- 1 file changed, 147 insertions(+), 78 deletions(-)
