pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed

From: Tobias Bussmann <t.bussmann@gmx.net>
To: pgsql-docs@lists.postgresql.org
Cc: Joe Conway <mail@joeconway.com>
Subject: Re: Docs for Generated Columns
Date: Sun, 26 May 2019 22:42:15 +0200
Message-ID: <3232E7C8-8182-403A-9BF1-06D23410BAEF@gmx.net> (raw)
In-Reply-To: <9997d7e0-b0d9-1ec5-365d-153b58ad533e@joeconway.com>
References: <071F9108-0335-4309-ACD3-262AF04A1817@gmx.net>
	<9997d7e0-b0d9-1ec5-365d-153b58ad533e@joeconway.com>

On 24.05.2019 14:21, Joe Conway <mail@joeconway.com> wrote:
>> The column cannot be written to, and when read the result of the
>> specified expression will be returned.
> That sounds reasonable to me.

Thank you for confirmation and review. Please find attached my proposed little doc patch for this issue.

Tobias

Attachments:

001-reword-gen-col-docs.patch (application/octet-stream, 1.4K) download
diff --git a/doc/src/sgml/ref/create_foreign_table.sgml b/doc/src/sgml/ref/create_foreign_table.sgml
index 5db15eb73e..25d2f09ed2 100644
--- a/doc/src/sgml/ref/create_foreign_table.sgml
+++ b/doc/src/sgml/ref/create_foreign_table.sgml
@@ -268,8 +268,8 @@ CHECK ( <replaceable class="parameter">expression</replaceable> ) [ NO INHERIT ]
     <listitem>
      <para>
       This clause creates the column as a <firstterm>generated
-      column</firstterm>.  The column cannot be written to, and when read it
-      will be computed from the specified expression.
+      column</firstterm>.  The column cannot be written to, and when read the
+      result of the specified expression will be returned.
      </para>

      <para>
diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml
index 44a61ef99e..8e1bfe4d78 100644
--- a/doc/src/sgml/ref/create_table.sgml
+++ b/doc/src/sgml/ref/create_table.sgml
@@ -813,8 +813,8 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
     <listitem>
      <para>
       This clause creates the column as a <firstterm>generated
-      column</firstterm>.  The column cannot be written to, and when read it
-      will be computed from the specified expression.
+      column</firstterm>.  The column cannot be written to, and when read the
+      result of the specified expression will be returned.
      </para>

      <para>

view thread (4+ messages)  latest in thread

Message-ID: <3232E7C8-8182-403A-9BF1-06D23410BAEF@gmx.net>
Permalink:  ../3232E7C8-8182-403A-9BF1-06D23410BAEF@gmx.net/
Also on:    postgresql.org/message-id/3232E7C8-8182-403A-9BF1-06D23410BAEF@gmx.net

copy link · copy postgr.es · copy git am

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-docs@postgresql.org
  Cc: t.bussmann@gmx.net, pgsql-docs@lists.postgresql.org, mail@joeconway.com
  Subject: Re: Docs for Generated Columns
  In-Reply-To: <3232E7C8-8182-403A-9BF1-06D23410BAEF@gmx.net>

* 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