improve documentation

some aspects are unclear:

• compilerVersion is only used when forking
• fork should indicate that it uses the built in version when false, not an executable.

Also:

• don't set parameters that only apply to forking when fork is false to make the code more readable
• specifiy which are specific to javac, or java in general (perhaps we should be able to assign a @category to a plugin parameter)