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:32:24 +0000 (14:32 -0500)
commit856ca51a23b56df6aab3ee9bffc66334b79be355
treec038b1e4218d91f1e3eea7a034d73a9b5ee5d374
parenteae0e20deffb0a73f7cb0e94746f94a1347e71b1
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: https://postgr.es/m/87sffqk4zp.fsf@wibble.ilmari.org
doc/src/sgml/ref/comment.sgml
doc/src/sgml/ref/security_label.sgml