Skip to main content

Posts

Showing posts with the label JavaDoc

Missing javaDoc

What is Javadoc? Javadoc comment explains: - what the class does, its author, and version. - what the method does, its parameter, return value, and thrown exception. Many times, instead of our source code, we share our JAR with the other team members and once they import our JAR into their project and start using it, they either: - Don't see any Javadoc comments for the provided methods and they see this message on hover over- "Note: The Javadoc for this element could neither be found in the attached source nor the attached Javadoc." - OR, they see partial comments as they do see the method params numbers but not the type, etc. How to Fix this error? 1) Make sure that you have JavaDoc in place. To generate Java Doc in Eclipse: – Select the “Generate JavaDoc” option from the Project menu Specify the location for the JavaDoc file on your system Select the project and then the packages/class for which you want to create the JavaDoc file. Then click Next and th...