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

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Doc: clarify use of NULL to drop comments and security labels.
Date: 2023-01-31 19:33:53
Message-ID: E1pMwO7-000w1R-NB@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers

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

Branch
------
REL_12_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/dbe294644380e6facd63aeaf3975af6188a219b9

Modified Files
--------------
doc/src/sgml/ref/comment.sgml | 16 ++++++++++++----
doc/src/sgml/ref/security_label.sgml | 29 ++++++++++++++++++++++-------
2 files changed, 34 insertions(+), 11 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Thomas Munro 2023-01-31 20:54:42 Re: pg_upgrade test failure
Previous Message Justin Pryzby 2023-01-31 17:28:06 Re: pg_upgrade test failure