Details

    • Type: Improvement Improvement
    • Status: Closed
    • Priority: Minor Minor
    • Resolution: Fixed
    • Affects Version/s: 6.0.7-5
    • Fix Version/s: 7.0.1
    • Component/s: doc
    • Labels:
      None

      Description

      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.

        Activity

        Hide
        Kim Haase added a comment -

        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.

        Show
        Kim Haase added a comment - 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.
        Hide
        Kim Haase added a comment -

        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).

        Show
        Kim Haase added a comment - 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).
        Hide
        Kim Haase added a comment -

        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.

        Show
        Kim Haase added a comment - 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.

          People

          • Assignee:
            Kim Haase
            Reporter:
            Brant Gurganus
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved: