From 0fb27fc8a5f484b87df6068076987719f0fb79bf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dagfinn=20Ilmari=20Manns=C3=A5ker?= Date: Tue, 31 Jan 2023 16:05:20 +0000 Subject: [PATCH v2] Clarify that COMMENT and SECURITY LABEL can be set to NULL in the synopses 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 case in the parameter list, per suggestion from Tom Lane. --- doc/src/sgml/ref/comment.sgml | 16 ++++++++++++---- doc/src/sgml/ref/security_label.sgml | 16 ++++++++++++---- 2 files changed, 24 insertions(+), 8 deletions(-) diff --git a/doc/src/sgml/ref/comment.sgml b/doc/src/sgml/ref/comment.sgml index 7499da1d62..470a6d0b5c 100644 --- a/doc/src/sgml/ref/comment.sgml +++ b/doc/src/sgml/ref/comment.sgml @@ -66,7 +66,7 @@ TRIGGER trigger_name ON table_name | TYPE object_name | VIEW object_name -} IS 'text' +} IS { 'text' | NULL } where aggregate_signature is: @@ -263,11 +263,19 @@ - text + 'text' - The new comment, written as a string literal; or NULL - to drop the comment. + The new comment, written as a string literal. + + + + + + NULL + + + Write NULL to drop the comment. diff --git a/doc/src/sgml/ref/security_label.sgml b/doc/src/sgml/ref/security_label.sgml index 20a839ff0c..e4eee77932 100644 --- a/doc/src/sgml/ref/security_label.sgml +++ b/doc/src/sgml/ref/security_label.sgml @@ -44,7 +44,7 @@ TABLESPACE object_name | TYPE object_name | VIEW object_name -} IS 'label' +} IS { 'label' | NULL } where aggregate_signature is: @@ -178,11 +178,19 @@ - label + 'label' - The new security label, written as a string literal; or NULL - to drop the security label. + The new security label, written as a string literal. + + + + + + NULL> + + + Write NULL to drop the security label. -- 2.34.1