pg.ddx.io  pgsql-hackers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: torikoshia <torikoshia@oss.nttdata.com>
To: Pgsql Hackers <pgsql-hackers@postgresql.org>
Subject: doc: add LITERAL tag to RETURNING
Date: Fri, 12 Jan 2024 14:56:45 +0900
Message-ID: <c0aa00b60a16c0ea2a4c5123b013acb9@oss.nttdata.com> (raw)

Hi,

RETURNING is usually tagged with appropriate tags, such as <LITERAL>, 
but not in the 'query' section of COPY.

https://www.postgresql.org/docs/devel/sql-copy.html

Would it be better to put <LITERAL> here as well?

-- 
Regards,

--
Atsushi Torikoshi
NTT DATA Group Corporation

Attachments:

  [text/x-diff] v1-0001-Added-literal-tag-for-RETURNING.patch (1.3K, ../c0aa00b60a16c0ea2a4c5123b013acb9@oss.nttdata.com/2-v1-0001-Added-literal-tag-for-RETURNING.patch)
  download | inline diff:
From 3c9efe404310bf01d79b2f0f006541ebc0b170a0 Mon Sep 17 00:00:00 2001
From: Atsushi Torikoshi <torikoshia@oss.nttdata.com>
Date: Fri, 12 Jan 2024 14:33:47 +0900
Subject: [PATCH v1] Added literal tag for RETURNING.

---
 doc/src/sgml/ref/copy.sgml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/doc/src/sgml/ref/copy.sgml b/doc/src/sgml/ref/copy.sgml
index 18ecc69c33..e2ffbbdf84 100644
--- a/doc/src/sgml/ref/copy.sgml
+++ b/doc/src/sgml/ref/copy.sgml
@@ -128,10 +128,10 @@ COPY { <replaceable class="parameter">table_name</replaceable> [ ( <replaceable
      </para>
      <para>
       For <command>INSERT</command>, <command>UPDATE</command> and
-      <command>DELETE</command> queries a RETURNING clause must be provided,
-      and the target relation must not have a conditional rule, nor
-      an <literal>ALSO</literal> rule, nor an <literal>INSTEAD</literal> rule
-      that expands to multiple statements.
+      <command>DELETE</command> queries a <literal>RETURNING</literal> clause
+      must be provided, and the target relation must not have a conditional
+      rule, nor an <literal>ALSO</literal> rule, nor an
+      <literal>INSTEAD</literal> rule that expands to multiple statements.
      </para>
     </listitem>
    </varlistentry>

base-commit: 08c3ad27eb5348d0cbffa843a3edb11534f9904a
-- 
2.39.2



view thread (4+ messages)  latest in thread

Message-ID: <c0aa00b60a16c0ea2a4c5123b013acb9@oss.nttdata.com>
Permalink:  ../c0aa00b60a16c0ea2a4c5123b013acb9@oss.nttdata.com/
Also on:    postgresql.org/message-id/c0aa00b60a16c0ea2a4c5123b013acb9@oss.nttdata.com

 ·  · 

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 using the --to and --cc options:
  reply via email

  To: pgsql-hackers@postgresql.org
  Cc: torikoshia@oss.nttdata.com
  Subject: Re: doc: add LITERAL tag to RETURNING
  In-Reply-To: <c0aa00b60a16c0ea2a4c5123b013acb9@oss.nttdata.com>

* 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