Generated/Virtual Columns: Insertable / Updateable

Added documentation.
doctrine#5728

docs/en/reference/annotations-reference.rst

@@ -123,6 +123,12 @@ Optional attributes:
 
 -  **nullable**: Determines if NULL values allowed for this column. If not specified, default value is false.
 
+-  **insertable**: Boolean value to determine if the column should be
+   included when inserting a new row into the underlying entities table. If not specified, default value is true.
+
+-  **updateable**: Boolean value to determine if the column should be
+   included when updating the row of the underlying entities table. If not specified, default value is true.
+
 -  **options**: Array of additional options:
 
    -  ``default``: The default value to set for the column if no value
@@ -193,6 +199,12 @@ Examples:
      */
     protected $loginCount;
 
+    /**
+     * Generated column
+     * @Column(type="string", name="user_fullname", insertable=false, updateable=false)
+     */
+    protected $fullname;
+
 .. _annref_column_result:
 
 @ColumnResult

docs/en/reference/attributes-reference.rst

@@ -89,6 +89,14 @@ Optional attributes:
 -  **nullable**: Determines if NULL values allowed for this column.
     If not specified, default value is ``false``.
 
+-  **insertable**: Boolean value to determine if the column should be
+   included when inserting a new row into the underlying entities table
+    If not specified, default value is ``true``.
+
+-  **updateable**: Boolean value to determine if the column should be
+   included when updating the row of the underlying entities table.
+    If not specified, default value is ``true``.
+
 -  **options**: Array of additional options:
 
    -  ``default``: The default value to set for the column if no value

docs/en/reference/basic-mapping.rst

@@ -199,6 +199,10 @@ list:
   unique key.
 - ``nullable``: (optional, default FALSE) Whether the database
   column is nullable.
+- ``insertable``: (optional, default TRUE) Whether the database
+  column should be inserted.
+- ``updateable``: (optional, default TRUE) Whether the database
+  column should be updated.
 - ``precision``: (optional, default 0) The precision for a decimal
   (exact numeric) column (applies only for decimal column),
   which is the maximum number of digits that are stored for the values.

docs/en/reference/xml-mapping.rst

@@ -256,6 +256,8 @@ Optional attributes:
    table? Defaults to false.
 -  nullable - Should this field allow NULL as a value? Defaults to
    false.
+-  insertable - Should this field be inserted? Defaults to true.
+-  updateable - Should this field be updated? Defaults to true.
 -  version - Should this field be used for optimistic locking? Only
    works on fields with type integer or datetime.
 -  scale - Scale of a decimal type.