Docs for Generated Columns - Mailing list pgsql-docs

From Tobias Bussmann
Subject Docs for Generated Columns
Date
Msg-id 071F9108-0335-4309-ACD3-262AF04A1817@gmx.net
Whole thread Raw
Responses Re: Docs for Generated Columns
List pgsql-docs
Hi,

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
introducedwith  

> This clause creates the column as a generated column. The column cannot be written to, and when read it will be
computedfrom the specified expression. 

To me this sounds confusing, if not wrong. Till v8 of the patch were STORED and VIRTUAL generated columns were
describedafterwards this was less obvious but now with only STORED it sounds like a reference to the VIRTUAL variant.
Notbeing 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.

Best regards
Tobias Bussmann

[1]: https://www.postgresql.org/docs/devel/sql-createtable.html
[2]: https://www.postgresql.org/docs/devel/sql-createforeigntable.html


pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: error: unrecognized privilege: 39 sql state: xx000
Next
From: Peter Eisentraut
Date:
Subject: graphviz file extension