pg.ddx.io  pgsql-committers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: Doc: clarify use of NULL to drop comments and security labels.
Date: Tue, 31 Jan 2023 19:33:53 +0000
Message-ID: <E1pMwO7-000w1I-Li@gemulon.postgresql.org> (raw)

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_15_STABLE

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

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



view thread (6+ messages)  latest in thread

Message-ID: <E1pMwO7-000w1I-Li@gemulon.postgresql.org>
Permalink:  ../E1pMwO7-000w1I-Li@gemulon.postgresql.org/
Also on:    postgresql.org/message-id/E1pMwO7-000w1I-Li@gemulon.postgresql.org

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients from your mail client; the link fills in
  the headers below: reply via email
  Some clients, webmail especially, drop In-Reply-To and References from
  a link, and the reply then starts a new thread: use the mbox below.

  To: pgsql-committers@postgresql.org
  Cc: tgl@sss.pgh.pa.us
  Subject: Re: pgsql: Doc: clarify use of NULL to drop comments and security labels.
  In-Reply-To: <E1pMwO7-000w1I-Li@gemulon.postgresql.org>
  References: <E1pMwO7-000w1I-Li@gemulon.postgresql.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox