8000269: Cleanup javadoc warnings

[Ulf Zibis]

Am 30.09.2012 12:54, schrieb Alan Bateman:
> On 29/09/2012 22:54, Ulf Zibis wrote:
>>
>> To me this is an ugly break in style.
> When a method signature is long or a method declares several checked exceptions that cause it to 
> slip over into more than one line then there are different conventions and we don't have 
> consistently in the JDK. Some people prefer to put the opening brace onto the next line, others 
> prefer put the opening brace at the end of the line. It's a matter of taste, I think prefer the 
> former, if only because I often find myself looking at unfamiliar code with lots of parameters and 
> exceptions and I want to quickly distinguish the method signatures from the method body.

Doesn't the 8-space-indentation rule on continuation lines serve for that problem?
I  tend to have the contraire problem, searching for the terminating brace of the signature, when it 
is "hidden" in the very left corner.

> In any case, I don't think it's worth spending time on this as this change is about fixing up 
> javadoc warnings and cross references, the minor changes to the formatting of the permission 
> classes are just drive-by clean-ups because the formatting of those classes is so odd. You are 
> right that more could be done on formatting on the classes that are touched in this webrev, like 
> L702 of java.io.FilePermission.

Correct, but I was thinking, if including the formatting in this changeset at all, then do it perfect.

-Ulf