I’m documenting code in Eclipse and have been using the /** followed by Enter a lot to insert the Javadoc template. However this does not always work for some reason, it will create the template for writing comments but it won’t automatically insert the @param and @return text. If I copy the exact same method to another class it will insert the full template.
It would be a big help if anyone could tell me why it won’t do this in some situations.
As far as I know this usually happens when Eclipse doesn’t know for sure which method you want to document.
A more reliable way would be to select the method/class etc. you want to create the JavaDoc for and press ALT + SHIFT + J or right click on the method in the class outline and clicking Source -> Generate element comment.