How can be a JSP ".tag" file documented?

Question

There is a JSP Tag file like this:

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

<%@ attribute name="attr" required="true" type="java.lang.String" rtexprvalue="true" description="FOOO" %>

<%@ attribute name="var" required="true" type="java.lang.String" rtexprvalue="false" description="BAAR" %>
<%@ variable name-from-attribute="var" variable-class="java.lang.String" alias="attrValue" scope="AT_BEGIN" %>

<c:set var="attrValue" value="${requestScope[attr]}" />

It seems to be possible to document the attributes. How to add documentation to the tag itself?

You have to describe it in the tag library descriptor: http://docs.oracle.com/javaee/5/tutorial/doc/bnamu.html — Jozef Chocholacek, Aug 02 '16 at 06:53

score 1 · Accepted Answer · answered Aug 02 '16 at 07:11

1

The proper place to describe a tag and its properties (including attributes) is the Tag Library Descriptor. The description attribute of the attribute directive is IMHO a left-over "from the dark past" and does not have any real use nowadays.

answered Aug 02 '16 at 07:11

Jozef Chocholacek

2,874
2
20
25

How can be a JSP ".tag" file documented?

1 Answers1