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:51 +0000 (14:32 -0500)
commite4035a9ca49d8f8bc19b949d6e2600048b198313
tree4a57be8467d334e3af09add4f11800a734e8c4b5
parentc5b2975ec183e8776f82bad33ec957ce58ec709a
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