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
diff --git a/Documentation/dev-eclipse.txt b/Documentation/dev-eclipse.txt
index 51c0bcd..b8d01e8 100644
--- a/Documentation/dev-eclipse.txt
+++ b/Documentation/dev-eclipse.txt
@@ -10,6 +10,20 @@
[[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.
