[config] added histogram tracker option (-Dlombok.timeConfig) and disable-entirely option (-Dlombok.disableConfig) to debug continuing speed issues with the config system, for an edge release.

1 files changed, 8 insertions, 0 deletions

diff --git a/doc/changelog.markdown b/doc/changelog.markdown
index d6c1b380..40a8e312 100644
--- a/doc/changelog.markdown
+++ b/doc/changelog.markdown
@@ -4,6 +4,14 @@ Lombok Changelog
 ### v1.14.5 "Edgy Guinea Pig"
 
 * WORK-IN-PROGRESS: A bunch of errors in the error log about 'Path must include project and resource name' seem to be related to slowdowns. This fix removes the errors, but does it remove the slowdowns? [Issue #682](https://code.google.com/p/projectlombok/issues/detail?id=682).
+    This edge release contains some special flags:
+
+    1. `-Dlombok.timeConfig`: Adding this switch adds profiling to config lookups. Every minute a histogram is printed to the error log (eclipse) or syserr (javac and others).
+        The 10 numbers printed list calls in exponential increasing millisecond durations (first number is 0 millis, second is 1, third is 2 to 4, etc). If the numbers seem
+        excessive to you, help us out and report your findings on our [newsgroup](https://groups.google.com/forum/#!topic/project-lombok/UNCvLSEGWik).
+    2. `-Dlombok.disableConfig`: Disables the config system (notably including all attempts to look up the location of, and read, `lombok.config` files) entirely.
+
+    Both flags can be used simultaneously. Add either or both of these switches in your `eclipse.ini`, directly under `-javaagent:lombok.jar`.
 
 ### v1.14.4 (July 1st, 2014)
 * BUGFIX: GWT produces errors in handlers on line 1 in any source files that use lombok; this has been fixed. [Issue #699](https://code.google.com/p/projectlombok/issues/detail?id=699)