Doc: clarify use of NULL to drop comments and security labels.
authorTom Lane <tgl@sss.pgh.pa.us>
Tue, 31 Jan 2023 19:32:24 +0000 (14:32 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Tue, 31 Jan 2023 19:33:24 +0000 (14:33 -0500)
commitc1827e9cd2d70a353c066b1b70961e514ebe1d9f
tree7c46d580b4c98fa1cd042f6ae97d9ba78be390ef
parent403d82dd54b58f9c1c64f7f7b00f396ce903a257
Doc: clarify use of NULL to drop comments and security labels.

This was only mentioned in the description of the text/label, which
are marked as being in quotes in the synopsis, which can cause
confusion (as witnessed on IRC).

Also separate the literal and NULL cases in the parameter list, per
suggestion from Tom Lane.

Also add an example of dropping a security label.

Dagfinn Ilmari MannsÃ¥ker, with some tweaks by me

Discussion: http://postgr.es/m/87sffqk4zp.fsf@wibble.ilmari.org
doc/src/sgml/ref/comment.sgml
doc/src/sgml/ref/security_label.sgml