tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject [Bug 54198] New: Improve HttpServletResponse#sendError(int) JavaDoc description
Date Fri, 23 Nov 2012 22:33:12 GMT
https://issues.apache.org/bugzilla/show_bug.cgi?id=54198

            Bug ID: 54198
           Summary: Improve HttpServletResponse#sendError(int) JavaDoc
                    description
           Product: Tomcat 6
           Version: 6.0.36
          Hardware: All
                OS: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Servlet & JSP API
          Assignee: dev@tomcat.apache.org
          Reporter: 1983-01-06@gmx.net
    Classification: Unclassified

This methods calls sendError(int, null) internally. Thus generating a HTML page
without a message. This is not mentioned in the docs. One could assume that the
response will be empty.

One could duplicate the first paragraph of the sendError(int,String) method and
alter it to "The server defaults to creating the response to look like an
HTML-formatted server error page with any specific message, setting the content
type to "text/html",..." further "If an error-page declaration has been made
for the web application corresponding to the status code passed in, it will be
served back." (Might need improvement in this case, I am not a native speaker).

Moreover, I would add "This method is effectively the same as calling
sendError(int, null)". Plus add @see #sendError(int,String).

Though the JavaDocs seems to be a verbatim copy of Oracle's Servlet API, it
does not reveal this information explicitly.

Should I provide a patch if that doc is available in svn.apache.org?

-- 
You are receiving this mail because:
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org


Mime
View raw message