Issue Details (XML | Word | Printable)

Key: JAVAEETUTORIAL-108
Type: Improvement Improvement
Status: Closed Closed
Resolution: Fixed
Priority: Minor Minor
Assignee: Kim Haase
Reporter: Brant Gurganus
Votes: 0
Watchers: 0
Operations

If you were logged in you would be able to see more operations.
javaeetutorial

VDL not crossreferenced

Created: 27/Jun/12 12:35 AM   Updated: 24/Apr/13 09:12 PM   Resolved: 24/Apr/13 09:12 PM
Component/s: doc
Affects Version/s: 6.0.7-5
Fix Version/s: 7.0.1

Time Tracking:
Not Specified

Tags:
Participants: Brant Gurganus and Kim Haase


 Description  « Hide

The page at http://docs.oracle.com/javaee/6/tutorial/doc/bnaia.html describing "Defining a Tag Attribute Type" brings up View Description Language (VDL) as the means by which custom tags are created. However, the creation of the custom tags is not covered nor is there a link to a page about custom tag creation. I think it is early to learn about custom tags in the tutorial sequence, so I'd say a link to elsewhere is most applicable.



Kim Haase added a comment - 24/Apr/13 09:12 PM

The entire section "Defining a Tag Attribute Type" applies to JSP development but not to JSF, so I have removed it. I made a few more updates in the EL chapter to make it apply better to JSF.


Kim Haase added a comment - 21/Aug/12 09:21 PM

Actually, the EL chapter contains additional material that needs to be updated for JSF (instead of JSP). Custom tags are used much less in JSF than in JSP, so we really don't need to talk about them this early; but they are used as examples elsewhere in the chapter.

I think the whole "Defining a Tag Attribute Type" section does after all need to be moved, possibly as a subsection of http://docs.oracle.com/javaee/6/tutorial/doc/bnawn.html, "Defining the Custom Component Tag in a Tag Library Descriptor." The custom component tag in that advanced chapter doesn't even have any custom attributes, so the topic remains theoretical (and should – it was more relevant at EE 5).


Kim Haase added a comment - 09/Jul/12 03:46 PM

Yes, we definitely need a forward cross-reference both here and in Chapter 4, where custom tags are first mentioned (http://docs.oracle.com/javaee/6/tutorial/doc/bnapk.html). Also, the terms "view" and "View Description Language" should be introduced earlier than they are, and "View Description Language" should be defined.