A review comment from [~prappo] on 8322036 mentioned that we can still improve the javadoc tool help output to make it more informative.

"Every option should provide three elements: a synopsis of what it is for, a set of possible values, and the default value."