1, 2: some fields do not have reasonable defaults therefore are commented out and are without default values (I was told that empty values are not handled well by Configuration), if you can think of reasonable defaults for these please let me know
3: will fix
4: reasonable, will do
5: Let's discuss off-line and come up with something that makes sense, it's my best guess from looking at code
6: This is a bit tricky, there's core-default.html which is built by ant docs (not ant javadocs) and resulting core-default.html is outside of javadoc docRoot. It can be referred to using "
/../core-default.html" (note the parent directory of docRoot). This makes the end result ok for now but it's dangerous because it makes javadoc docs rely on docs built outside of javadoc.
7: This comment was there before, thought it's out of scope for this bug, i.e. I am trying to document existing variables, not decide which ones are used or not etc.