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