Add a description about annotation processing

Author: nakamura-to

docs/sources/annotation-processing.rst

@@ -84,6 +84,11 @@ Eclipse
 
 プロジェクトの「Properties」-「Java Compiler」-「Annotation Processing」の項目でオプションを登録します。
 
+IntelliJ IDEA
+=============
+
+Preferrences から Build, Execution, Deployment > Compiler > Annotation Processors の画面を開き登録します。
+
 javac
 =====
 

docs/sources/build.rst

@@ -14,6 +14,8 @@ GroupId と ArtifactId の名称は以下の通りです。
 :GroupId: org.seasar.doma
 :ArtifactId: doma
 
+.. _eclipse-build:
+
 Eclipse を使ったビルド
 ======================
 
@@ -56,6 +58,17 @@ Factory Path の設定
 
 |
 
+IntelliJ IDEA を使ったビルド
+================================
+
+IntelliJ IDEA でビルドを行う際のポイントは以下の通りです。
+
+* Module の設定で Inherit project compile output pathを有効にする
+* Preferences の設定で注釈処理を有効にする
+* 注釈処理で生成されたコードが出力されるディレクトリを Generated Sources Root に設定する
+
+詳細な設定方法については :ref:`idea-annotation-processor` を参照してください。
+
 Gradle を使ったビルド
 =====================
 

docs/sources/getting-started-eclipse.rst

@@ -113,9 +113,14 @@ clone されたディレクトリに移動します。
 
 .. note::
 
-  環境変数 ``JAVA_HOME`` に JDK 8 をインストールしたディレクトリを設定しておいてください。
+  環境変数 ``JAVA_HOME`` に JDK 8 （もしくは JDK 9 や 10）をインストールしたディレクトリを設定しておいてください。
   gradlew の実行に必要です。
 
+.. note::
+
+  Eclipse 用の設定ファイルには注釈処理の設定が含まれます。
+  手動で設定する場合は、 :ref:`eclipse-build` を参照ください。
+
 
 Eclipse のメニューからFile > Import... を実行し
 'Existing Projects into Workspace' を選んで simple-boilerplate をインポートします。

docs/sources/getting-started-idea.rst

@@ -49,18 +49,29 @@ IntelliJ IDEA を起動して Import Project を実行し、clone した simple-
 .. image:: images/idea-welcome.png
    :width: 60 %
 
+|
+
+
 Import project from external model をチェックし、Gradle を選択します。 
 
 .. image:: images/idea-import-project.png
    :width: 100 %
 
+|
+
+
 Use auto import をチェックし、 Create separate module per source set のチェックを外します。最後に Finish を押してください。
 
 .. image:: images/idea-import-project-settings.png
    :width: 100 %
 
+|
+
+
 Build ツールウィンドウに synced successfully というメッセージが表示されればインポートは成功です。
 
+.. _idea-annotation-processor:
+
 Annotation Processor に関する設定
 =====================================
 
@@ -69,12 +80,17 @@ Project ツールウィンドウのコンテキストメニューから Open Mod
 .. image:: images/idea-open-module-settings.png
    :width: 100 %
 
+|
+
 Modules の Paths の設定画面を開き、Inherit project compile output path が選択されていることを確認してください。
 選択されていない場合は選択してください。
 
 .. image:: images/idea-output-path.png
    :width: 100 %
 
+|
+
+
 Preferrences から Build, Execution, Deployment > Compiler > Annotation Processors を開きます。
 Enable annotation processing をチェックしてください。
 Module content root をチェックしてください。
@@ -84,6 +100,9 @@ Production sources directory には gen/production 、Test sources directory に
 .. image:: images/idea-annotation-processors.png
    :width: 100 %
 
+|
+
+
 メニューから Build Project を実行してください。
 ビルドにより Annotation Processor により生成されたコードが gen/production に出力されます。
 Project ツールウィンドウのコンテキストメニューから Mark Directory as | Generated Sources Root を選択し、