Re: Docs for Generated Columns

Tobias Bussmann <[email protected]>
Newsgroups gmane.comp.db.postgresql.devel.documentation
Message-ID <[email protected]>
On 24.05.2019 14:21, Joe Conway <[email protected]> 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
001-reword-gen-col-docs.patch (application/octet-stream, 1.4 KB)
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>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.