Menu

#13 Overrides JavaDoc comments.

open-accepted
None
5
2010-05-07
2010-01-05
No

When "Replace existing headers" is turned on, JavaDoc comments are overridden if they are placed at the beginning of file (some of us DO create package-info.java files ;-]).
In perfect case the plug-in should not touch JavaDoc at all and not permit to use /** on the first line of copyright notice comment. Alternatively, the plug-in could have "Do not replace JavaDoc" option nex to "Replace existing headers".

Discussion

  • Vilius Normantas

    -- Alternatively, the plug-in could have "Do not replace JavaDoc" option nex to "Replace existing headers".
    I gave it a second thought and.. It actually doesn't solve anything.

    So my proposal is this:
    ++ The plug-in should not touch JavaDoc at all and not permit to use /** on the first line of copyright notice comment.

     
  • Eric Wuillai

    Eric Wuillai - 2010-05-07

    Hi,
    The wizard is not designed only for Java, but must be compliant with all possible languages. So I can add a "Do not replace JavaDoc" option. If I did that, I would have to add equivalent options for other languages.
    Perhaps the solution is to add a new option an header format definitions based on pattern recognition. I will look at that.

     
  • Eric Wuillai

    Eric Wuillai - 2010-05-07
    • assigned_to: nobody --> ewuillai
    • status: open --> open-accepted
     

Log in to post a comment.