Javadoc for custom tags in JSP

Question

I am creating a custom JSP tag using a class which extends TagSupport and a tld. I want to create a javadoc such that when a designer uses these tags, like for example in eclipse, on ctrl+space (in windows), the designer must get tag info and same thing should happen for each atribute in the tag. I tried giving /** .. */ in class, it did not work. How to do this ? If there is an easier tool, please mention tutorial link.

Answer 1

It should go in <description> element of the <tag> and <attribute> elements in the .tld file.

E.g.

<tag>
    <description>This tag does foo.</description>
    <name>foo</name>
    ...
    <attribute>
        <description>Sets the value of foo.</description>
        <name>value</name>
        ...
    </attribute>
</tag>