JavaServer Pages, 3rd Edition

General Library Elements

The first set of top-level elements, in this order, describes the library itself:

• The optional <description> element can provide a short description of the library, perhaps something a tool may display to help users decide if the library is what they are looking for.

• The <display-name> element is an optional element, containing a name of the library suitable for display by an authoring tool.

• An <icon> element with nested <small-icon> and <large-icon> elements can optionally be used to name image files containing icons for the library, again something a page-authoring tool may use. The values are file paths for files containing either GIF or JPEG images, interpreted as relative to the TLD file. The small icon should be 16x16 pixels, and the large 32x32 pixels.

• The <tlib-version> element is mandatory and specifies the tag library version. The version should be specified as a series of numbers separated by dots. In other words, the normal conventions for software version numbers, such as 1.1 or 2.0.3, should be used.

• The <short-name> element is intended for use by page-authoring tools. It’s a mandatory element that should contain the default prefix for the action elements. In Example 21-13, the value is ora, meaning that an authoring tool by default generates custom action elements using the ora prefix, for instance <ora:menuItem page="page1.jsp">. A tool may also use the element value as the value of the prefix attribute if it generates the taglib directive ...