Re: Docs for Generated Columns - Mailing list pgsql-docs

From Joe Conway
Subject Re: Docs for Generated Columns
Date
Msg-id 9997d7e0-b0d9-1ec5-365d-153b58ad533e@joeconway.com
Whole thread Raw
In response to Docs for Generated Columns  (Tobias Bussmann <t.bussmann@gmx.net>)
Responses Re: Docs for Generated Columns  (Tobias Bussmann <t.bussmann@gmx.net>)
List pgsql-docs
On 5/23/19 5:50 PM, Tobias Bussmann wrote:
> while reading though the docs of the upcoming pg12 features, I
> stumbled upon some wording regarding generated columns: both in
> create_table.sgml [1] and create_foreign_table.sgml [2] the paragraph
> for the GENERATED ALWAYS AS clause is introduced with
>> This clause creates the column as a generated column. The column
>> cannot be written to, and when read it will be computed from the
>> specified expression.

> To me this sounds confusing, if not wrong. Till v8 of the patch were
> STORED and VIRTUAL generated columns were described afterwards this
> was less obvious but now with only STORED it sounds like a reference
> to the VIRTUAL variant.

No doubt this is flat out wrong.


> Not being I native english speaker I'm restrained to send a patch but
> may I suggest the following for discussion:

> The column cannot be written to, and when read the result of the
> specified expression will be returned.


That sounds reasonable to me.

Joe

--
Crunchy Data - http://crunchydata.com
PostgreSQL Support for Secure Enterprises
Consulting, Training, & Open Source Development


Attachment

pgsql-docs by date:

Previous
From: Peter Eisentraut
Date:
Subject: graphviz file extension
Next
From: Joe Conway
Date:
Subject: Re: graphviz file extension