The escape attribute for UISelectItem and SelectItem isn't documented very well.

[eclipse-faces-bot]

1. Javadocs for UISelectItem has the methods to manipulate the escape property,
however the class docs do not mention that this property is used with creating a
javax.faces.model.SelectItem instance.

2. Javadocs for javax.faces.model.SelectItem methods setEscape(boolean) and
isEscape() are not complete. They basically state they manipulate the escape
property but it's not clear (at least not without reviewing UISelectItem) what
the escape attribute is for. These docs should be enhanced.

3. The spec document mentions the escape attribute (wrt
UISelectItem/SelectItem) in the preface and in the documentation for
f:selectItem. Chapter 4 of the spec, which talks about the properites of
UISelectItem and SelectItem, makes no mention of this attribute and it should.

4. The renderkit docs for rendering options should make clear the usage of the
escape attribute.

Environment

Operating System: All
Platform: All

Affected Versions

[1.2]

[eclipse-faces-bot]

@glassfishrobot Commented
Reported by @rlubke

[eclipse-faces-bot]

@glassfishrobot Commented
rogerk said:
whiteboard

[eclipse-faces-bot]

@glassfishrobot Commented
@edburns said:
take ownership

[eclipse-faces-bot]

@glassfishrobot Commented
@edburns said:
fix checked in.

[eclipse-faces-bot]

@glassfishrobot Commented
@edburns said:
Prepare to delete "spec" subcomponent.

[eclipse-faces-bot]

@glassfishrobot Commented
Marked as fixed on Monday, November 23rd 2009, 11:48:11 pm

[eclipse-faces-bot]

@glassfishrobot Commented
@manfredriem said:
Closing resolved issue out

[eclipse-faces-bot]

@glassfishrobot Commented
This issue was imported from java.net JIRA JAVASERVERFACES_SPEC_PUBLIC-430

[eclipse-faces-bot]

• Issue Imported From: The escape attribute for UISelectItem and SelectItem isn't documented very well. javaee/javaserverfaces-spec#430
• Original Issue Raised By:@glassfishrobot
• Original Issue Assigned To: @edburns
• Original Issue Closed By:@glassfishrobot