javadoc

Javadoc template generator

I have a large codebase without javadoc and I want to run a program to write a skeleton with the basic javadoc information (e.g. for each method's parameter write @param...) so I just have to fill the gaps left. Somebody knows a good solution for this? Edit: JAutodoc is what I was looking for, it has ant tasks, an eclipse plugin and u...

Best java tools for emacs

I'm a long-time emacs user, and I'm now working about 1/2 time in Java. What are the best emacs libraries for Debugging Java Code Completion/Intellisense Javadoc browsing ? ...

Why am I getting a ClassCastException when generating javadocs?

I'm using ant to generate javadocs, but get this exception over and over - why? I'm using JDK version 1.6.0_06. [javadoc] java.lang.ClassCastException: com.sun.tools.javadoc.ClassDocImpl cannot be cast to com.sun.javadoc.AnnotationTypeDoc [javadoc] at com.sun.tools.javadoc.AnnotationDescImpl.annotationType(AnnotationDescImpl.java...

Why does the Eclipse code formatter break </a> in a Javadoc @see tag?

I'm using Eclipse 3.4 and have configured the Java code formatter with all of the options on the Comments tab enabled. The problem is that when I format a document comment that contains: * @see <a href="test.html">test</a> the code formatter inserts a space in the closing HTML, breaking it: * @see <a href="test.html">test< /a> Why?...

How do I get javadoc to link to the Java API using an Ant task?

Right now my ant task looks like. <javadoc sourcepath="${source}" destdir="${doc}"> <link href="http://java.sun.com/j2se/1.5.0/docs/api/" /> </javadoc> And I'm getting this warning: javadoc: warning - Error fetching URL: http://java.sun.com/j2se/1.5.0/docs/api/package-list How do I get the javadoc to properly link to the API? ...

Why does the default IntelliJ default class javadoc comment use non-standard syntax?

Why does the default IntelliJ default class javadoc comment use non-standard syntax? Instead of creating a line with "User: jstauffer" it could create a line with "@author jstauffer". The other lines that it creates (Date and Time) probably don't have javadoc syntax to use but why not use the javadoc syntax when available? For reference...

How do you read JavaDoc?

What tools/websites do you use to read JavaDocs? I currently use Firefox with 20+ tabs open when working on a J2EE project to have all the documentation available which is not very usable, is eating too much memory and is not searchable. What I would expect from such a tool/website: Aggregate JavaDocs from different locations Direct...

Attaching additional javadoc in Intellij IDEA

When I use quick documentaion lookup (Ctrl+Q) on j2ee classes or annotations in IDEA I only get an empty javadoc. It only contains the basics like class name. How do I add the javadoc to the libs IDEA provides itself? ...

Can the NetBeans code formatter be made to format javadoc comments?

The NetBeans 6.1 editor doesn't seem to like to wrap comments, and the code formatter seems to ignore them. For JavaDoc comments, this behaviour seems inappropriate, as you can end up spending a lot of wasted time manually reflowing paragraphs. I was wondering if there's some magic setting to get the builtin code formatter, or the edit...

In javaDoc, what's the best way of representing attributes in XML?

When you're adding javaDoc comments to your code and you're outlining the structure of an XML document that you're passing back, what's the best way to represent attributes? Is there a best practice for this? My general structure for my javaDoc comments is like this: /** * ... * * @return XML document in the form: * * <pre> * &...

What is the correct term for the documentation that we put just above a method declaration?

I'm writing a whitepaper and realized that I am not sure what the official term is for the kind of internal documentation that we put as a comment block before a declaration of definition. The same thing that eventually becomes JavaDoc member documentation. It's not simply internal documentation, and I'm not sure "header documentation"...

Ghostdoc-like plugin for IntelliJ IDEA

I've become lazy in my old age. For my C# work I've become quite reliant on Roland Weigelt's excellent GhostDoc plugin for Visual Studio. Is anyone aware of a similar plugin for Java work in IntelliJ IDEA? ...

Checkstyle's PackageHtml-rule ignores package-info.java

I use checkstyle to analyze my code. A useful rule is PackageHtml, that checks, if a package contains a Javadoc-description. But with newer java-version it's recommended to use package-info.java instead of package.html. Problem is, checkstyle ignores the package-info.java and reports a rule violation. How can checkstyle be configured to ...

What is the best way to use JavaDoc to document a Java enum?

I've just started using Java's enums in my own projects (I have to use JDK 1.4 at work) and I am confused as to the best practice of using JavaDoc for an enum. I have found that this method works, but the resultant code is a little unrefined: /** * Doc for enum */ public enum Something { /** * First thing */ FIRST_THING, /** * Second t...

Do you use Javadoc for every method you write?

Should I be writing Doc Comments for all of my java methods? ...

Will MS Visual Studio 2008 show help on my own functions if I use Javadoc style comments for them?

For example in C# or in JavaScript documents. If not, is there point in using Javadoc comments in ASP.NET programming? ...

Attach Javadoc to Library in NetBeans

I'm new to using the NetBeans IDE. When I try to look at the documentation for say the java API (example, System class), it says that the javadoc is not installed. How do I install the documentation? ...

Code documentation for delphi similar to javadoc or c# xml doc

I need a code documentation tool similar to javadoc or c# xml doc for delphi code. What is the best tool? I prefer a technology, which is in the future compatible to the Microsoft sandcastle project. ...

Is it possible to obtain warnings from javadoc when something missed in javadoc-comments?

Accidentally I may forget to describe some parameters or exception throwing (or something else) when documenting methods or classes, etc. Is it possible to run javadoc in such a way that it warns me about missing documentation items? (I use ant script for generating documentation) ...

Grouping javadoc methods

I'd like to group the methods in the javadoc for my class. For example: Admin methods: blah1 blah2 Accessor methods: foo1 foo2 Do you know of any way I can achieve this in javadoc? Are there any doclets available for doing this? Thanks, Calum ...