« New build of IntelliJ IDEA 12 EAP build 122.395 is available
Better Experience with Tapestry »

“Fix Doc Comment” Action is Available

September 26th, 2012 by Denis.Zhdanov

A new action for code documentation maniacs, called Fix doc comment, has just been cooked at the JetBrains’ oven.

Please follow the recipe:

  • Find or create a stub doc comment.
  • Fix documentation problems quickly whenever you wish.


The first case, when you may need the new action, is rather simple. Call it, when a caret is somewhere within a class, field or method, which does not have a doc comment. A doc comment stub will be added, and the caret will be moved to proper position for entering a comment.

The second use-case for the new action, is to fix an existing documentation problems. For example, the signature of some method has been changed, and the doc comment is valid anymore. We have an inspection, which allows to fix such problems one-by-one. It adds missing @param tag, return outdated @return, etc. The new action can fix these problems at once.

Note, that by default there is no any shortcut assigned to this action. However you can do it by yourself in Settings | Keymap.

We hope the new action will save your time, when you document your code or just fix the problems.

Currently the new action is available only for Java. But we hope to implement it soon for other languages too.

Please find this feature in the latest IntelliJ IDEA 12 EAP and submit your feedback to our issue tracker.

This entry was posted on Wednesday, September 26th, 2012 at 7:24 am and is filed under New Features. You can follow any responses to this entry through the RSS 2.0 feed. You can skip to the end and leave a response. Pinging is currently not allowed.

9 Responses to ““Fix Doc Comment” Action is Available”

  1. Arikon Says:
    September 26th, 2012 at 8:20 am

    This feature do not work with JavaScript code =(

  2. Denis.Zhdanov Says:
    September 26th, 2012 at 8:27 am

    The feature works with java code only at the moment. However, it’s implemented in pluggable manner, that’s why it wouldn’t be hard to provide it for other languages. Please submit corresponding feature request that targets js support.

  3. jtonic Says:
    September 27th, 2012 at 3:53 pm

    It would be great if the action have a default shortcut (Alt+Shift+J - Eclipse shortcut for creating a javadoc comment).

    Useful feature

    Thank you

  4. Denis.Zhdanov Says:
    September 28th, 2012 at 1:55 am

    Sorry but that shortcut is already occupied by ‘Surround with Live Template’ action. It has been at the IDE for a while and many users are accustomed to it.

    Denis

  5. Philip Herbst Says:
    September 28th, 2012 at 3:38 am

    What about Ctrl+Alt+Shift+J?

    Philip

  6. Erik Pragt Says:
    September 28th, 2012 at 8:29 am

    Hmm, for me, it doesn’t work. I’ve created a method, say:
    /**
    * @param object The object to process
    */
    boolean isProcessed(WorkItem item)

    ‘object’ here is of course an incorrect parameter name, so I ‘fix’ it using my shortcut (ctrl+shift+alt+p), and nothing happens. If I remove the documentation, the document template is added, but fixing doesn’t work.

  7. Erik Pragt Says:
    September 28th, 2012 at 8:33 am

    I just checked it a bit more, and when there is already Javadoc on the method, my shortcut doesn’t jump to the Javadoc, either if it’s correct or incorrect. But maybe I’m missing the idea of this shortcut?

  8. Denis.Zhdanov Says:
    September 28th, 2012 at 9:06 am

    You got the idea right, it looks like the ‘fix’ part hasn’t been included to the last EAP. Please wait for the next build.

  9. Erik Pragt Says:
    October 3rd, 2012 at 6:08 am

    Okay, thanks Denis, will do!

Leave a Reply