Format for JDK 6/7 changeset comments?

[David Holmes - Sun Microsystems]

Mark,

Mark Reinhold said the following on  7/11/07 01:12 PM:
> 
>>  >>> about the change. This is particularly pertinent as many of our bug
>>  >>> synopses don't shed any light on the nature of the bug let alone the
>>  >>> nature of the fix.
>>
>>    Then why not the synopsis of the bug? We do this all the time.
> 
> I think you meant to write "why not _edit_ the synopsis of the bug?", and
> I completely agree.  I do that all the time, and I regularly encourage
> others to do so.  There's no good reason to retain a bad synopsis.

Very often the synopsis reflects the circumstances under which the user 
encountered the bug eg:

    test regression/java/lang/Foo throws IllegalArgumentException

or

    Foo applet crashes after Java 6 update

or

   SIGSEGV running xxxx with option yyyy

Are you suggesting that once the cause of a bug is determined then the 
synopsis should be changed to reflect that? I've updated a few "bad" 
synopses in my time too, but not generally to the extent of changing 
them from being failure oriented to being cause oriented.

Cheers,
David Holmes