From c20dff21ee428e3a2c3aca7d10b4d6077584d174 Mon Sep 17 00:00:00 2001 From: David Pursehouse Date: Fri, 28 Aug 2015 09:41:14 +0900 Subject: [PATCH] Dev doc: Document the maxCompiledUnitsAtOnce setting in Eclipse This setting is needed to make annotation processing work reliably. See the related discussion on repo-discuss: https://groups.google.com/d/msg/repo-discuss/rpv-ElAWr2Y/CbXj6NL2BwAJ Change-Id: I7cf967a2207b6c9e5dd75de3647be3a71c9db948 --- Documentation/dev-eclipse.txt | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/Documentation/dev-eclipse.txt b/Documentation/dev-eclipse.txt index 51c0bcd969..b8d01e8672 100644 --- a/Documentation/dev-eclipse.txt +++ b/Documentation/dev-eclipse.txt @@ -10,6 +10,20 @@ runtime debugging environment. [[setup]] == Project Setup +In your Eclipse installation's `eclipse.ini` file, add the following line in +the `vmargs` section: + +---- + -DmaxCompiledUnitsAtOnce=10000 +---- + +Without this setting, annotation processing does not work reliably and the +build is likely to fail with errors like: + +---- + Could not write generated class ... javax.annotation.processing.FilerException: Source file already created +---- + In Eclipse, choose 'Import existing project' and select the `gerrit` project from the current working directory.