Background: The current ExternalContext javadoc describes its behavior in a
portlet environment assuming the implementation maps directly to the portlet
APIs. In many cases better more consistent behavior can be provided by the
bridge. We chose to ignore the JSF javadoc and define/implement what we
Need: It would be best if either the javadoc were updated to match the bridge's
definitions of ExternalContext behavior or the portlet descriptions were removed
entirely and instead we insert a reference to JSR 301 which defines this
behavior in the portlet environment.