JavaDoc in fron of methods breaks their code formatting. For example, I have set braces formatting to "Next line if wrapped", yet the following two similarly formatted methods (actually adjacent in the code):
are reformatted differently, like this:
The reason is that the JavaDoc prevents the second method formatting correctly. If you remove all JavaDoc, they format correctly. If you put JavaDoc in front of both, they both format incorrectly!