Doc: clarify use of NULL to drop comments and security labels.

Tom Lane <tgl@sss.pgh.pa.us>

Commit: 5fb1809eb966ec04ce2ec8fa4f0c382092659f03
Author: Tom Lane <tgl@sss.pgh.pa.us>
Date: 2023-01-31T19:33:05Z
Releases: 13.10
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

Files

PathChange+/−
doc/src/sgml/ref/comment.sgml modified +12 −4
doc/src/sgml/ref/security_label.sgml modified +22 −7

Documentation touched

Discussion