Document that the auto-generated value is set only if the identity field is either null or less than 0

nakamura-to · nakamura-to · commit ef90a48a91ed · 2018-01-08T01:06:53.000+09:00
diff --git a/docs/sources/entity.rst b/docs/sources/entity.rst
@@ -185,6 +185,8 @@ Entity（エンティティ）は、データベースのテーブルやクエ
 
   フィールドの型が :doc:`embeddable` の場合、　``@Id`` は指定できません。
 
+.. _identity-auto-generation:
+
 識別子の自動生成
 ~~~~~~~~~~~~~~~~
 
@@ -201,7 +203,8 @@ Entity（エンティティ）は、データベースのテーブルやクエ
 
 .. note::
 
-  プリミティブ型を使う場合、自動生成された値が確実に設定されるようにするには初期値に ``-1`` など ``0`` 未満の値を明示してください。
+  自動生成された値が識別子フィールドに設定される条件は、フィールドの値が ``null`` もしくは ``0`` 未満であることです。
+  プリミティブ型を使う場合は、フィールドの初期値に ``-1`` など ``0`` 未満の値を明示してください。
 
 IDENTITYを使った識別子の自動生成
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/sources/query/batch-insert.rst b/docs/sources/query/batch-insert.rst
@@ -49,6 +49,8 @@ SQLの自動生成によるバッチ挿入
 :doc:`../entity` の識別子に、 ``@GeneratedValue`` が注釈されている場合、
 識別子が自動的に生成され設定されます。
 
+注意点については :ref:`identity-auto-generation` を参照ください。
+
 バージョン番号
 --------------
 
diff --git a/docs/sources/query/insert.rst b/docs/sources/query/insert.rst
@@ -55,6 +55,8 @@ SQLの自動生成による挿入
 :doc:`../entity` の識別子に、 ``@GeneratedValue`` が注釈されている場合、
 識別子が自動的に生成され設定されます。
 
+注意点については :ref:`identity-auto-generation` を参照ください。
+
 バージョン番号
 --------------
 
