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
This commit is contained in:
David Pursehouse
2015-08-28 09:41:14 +09:00
parent 2b16f6a478
commit c20dff21ee

View File

@@ -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.