Author: markt Date: Tue Sep 10 19:21:22 2013 New Revision: 1521594 URL: http://svn.apache.org/r1521594 Log: Fix https://issues.apache.org/bugzilla/show_bug.cgi?id=55383 for the main web site Improve markup and design Patch provided by Konstantin Preißer
Added: tomcat/site/trunk/docs/images/tomcat.png (with props) tomcat/site/trunk/xdocs/images/tomcat.png - copied unchanged from r1521483, tomcat/trunk/webapps/docs/images/tomcat.png Modified: tomcat/site/trunk/docs/bugreport.html tomcat/site/trunk/docs/ci.html tomcat/site/trunk/docs/contact.html tomcat/site/trunk/docs/download-60.html tomcat/site/trunk/docs/download-70.html tomcat/site/trunk/docs/download-80.html tomcat/site/trunk/docs/download-connectors.html tomcat/site/trunk/docs/download-native.html tomcat/site/trunk/docs/findhelp.html tomcat/site/trunk/docs/getinvolved.html tomcat/site/trunk/docs/heritage.html tomcat/site/trunk/docs/index.html tomcat/site/trunk/docs/irc.html tomcat/site/trunk/docs/legal.html tomcat/site/trunk/docs/lists.html tomcat/site/trunk/docs/maven-plugin.html tomcat/site/trunk/docs/migration-6.html tomcat/site/trunk/docs/migration-7.html tomcat/site/trunk/docs/migration-8.html tomcat/site/trunk/docs/migration.html tomcat/site/trunk/docs/oldnews-2010.html tomcat/site/trunk/docs/oldnews-2011.html tomcat/site/trunk/docs/oldnews-2012.html tomcat/site/trunk/docs/oldnews.html tomcat/site/trunk/docs/resources.html tomcat/site/trunk/docs/security-3.html tomcat/site/trunk/docs/security-4.html tomcat/site/trunk/docs/security-5.html tomcat/site/trunk/docs/security-6.html tomcat/site/trunk/docs/security-7.html tomcat/site/trunk/docs/security-8.html tomcat/site/trunk/docs/security-impact.html tomcat/site/trunk/docs/security-jk.html tomcat/site/trunk/docs/security-native.html tomcat/site/trunk/docs/security.html tomcat/site/trunk/docs/stylesheets/tomcat-printer.css tomcat/site/trunk/docs/stylesheets/tomcat.css tomcat/site/trunk/docs/svn.html tomcat/site/trunk/docs/tomcat-55-eol.html tomcat/site/trunk/docs/tools.html tomcat/site/trunk/docs/whichversion.html tomcat/site/trunk/docs/whoweare.html tomcat/site/trunk/xdocs/stylesheets/tomcat-printer.css tomcat/site/trunk/xdocs/stylesheets/tomcat-site.xsl tomcat/site/trunk/xdocs/stylesheets/tomcat.css Modified: tomcat/site/trunk/docs/bugreport.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/bugreport.html?rev=1521594&r1=1521593&r2=1521594&view=diff ============================================================================== --- tomcat/site/trunk/docs/bugreport.html (original) +++ tomcat/site/trunk/docs/bugreport.html Tue Sep 10 19:21:22 2013 @@ -1,701 +1,194 @@ -<html> -<head> -<META http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>Apache Tomcat - Reporting Bugs</title> -<meta name="author" content="Glenn L. Nielsen"> -<link type="text/css" href="stylesheets/tomcat.css" rel="stylesheet"> -<link type="text/css" href="stylesheets/tomcat-printer.css" rel="stylesheet" media="print"> -</head> -<body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"> -<table border="0" width="100%" cellspacing="0"> -<!--PAGE HEADER--> -<tr> -<td> -<!--PROJECT LOGO--><a href="http://tomcat.apache.org/"><img src="./images/tomcat.gif" align="left" alt="Tomcat Logo" border="0"></a></td><td><font face="arial,helvetica,sanserif"> -<h1>Apache Tomcat</h1> -</font></td><td> -<!--APACHE LOGO--><a href="http://www.apache.org/"><img src="http://www.apache.org/images/asf-logo.gif" align="right" alt="Apache Logo" border="0"></a></td> -</tr> -</table> -<div class="searchbox noPrint"> -<form action="http://www.google.com/search" method="get"> -<input value="tomcat.apache.org" name="sitesearch" type="hidden"><input value="Search the Site" size="25" name="q" id="query" type="text"><input name="Search" value="Search Site" type="submit"> -</form> -</div> -<table border="0" width="100%" cellspacing="4"> -<!--HEADER SEPARATOR--> -<tr> -<td colspan="2"> -<hr noshade size="1"> -</td> -</tr> -<tr> -<!--LEFT SIDE NAVIGATION--> -<td width="20%" valign="top" nowrap="true" class="noPrint"> -<p> -<strong>Apache Tomcat</strong> -</p> -<ul> -<li> -<a href="./index.html">Home</a> -</li> -<li> -<a href="./taglibs/">Taglibs</a> -</li> -<li> -<a href="./maven-plugin.html">Maven Plugin</a> -</li> -</ul> -<p> -<strong>Download</strong> -</p> -<ul> -<li> -<a href="./whichversion.html">Which version?</a> -</li> -<li> -<a href="./download-80.cgi">Tomcat 8.0</a> -</li> -<li> -<a href="./download-70.cgi">Tomcat 7.0</a> -</li> -<li> -<a href="./download-60.cgi">Tomcat 6.0</a> -</li> -<li> -<a href="./download-connectors.cgi">Tomcat Connectors</a> -</li> -<li> -<a href="./download-native.cgi">Tomcat Native</a> -</li> -<li> -<a href="http://archive.apache.org/dist/tomcat/">Archives</a> -</li> -</ul> -<p> -<strong>Documentation</strong> -</p> -<ul> -<li> -<a href="./tomcat-8.0-doc/index.html">Tomcat 8.0</a> -</li> -<li> -<a href="./tomcat-7.0-doc/index.html">Tomcat 7.0</a> -</li> -<li> -<a href="./tomcat-6.0-doc/index.html">Tomcat 6.0</a> -</li> -<li> -<a href="./connectors-doc/">Tomcat Connectors</a> -</li> -<li> -<a href="./native-doc/">Tomcat Native</a> -</li> -<li> -<a href="http://wiki.apache.org/tomcat/FrontPage">Wiki</a> -</li> -<li> -<a href="./migration.html">Migration Guide</a> -</li> -</ul> -<p> -<strong>Problems?</strong> -</p> -<ul> -<li> -<a href="./security.html">Security Reports</a> -</li> -<li> -<a href="./findhelp.html">Find help</a> -</li> -<li> -<a href="http://wiki.apache.org/tomcat/FAQ">FAQ</a> -</li> -<li> -<a href="./lists.html">Mailing Lists</a> -</li> -<li> -<a href="./bugreport.html">Bug Database</a> -</li> -<li> -<a href="./irc.html">IRC</a> -</li> -</ul> -<p> -<strong>Get Involved</strong> -</p> -<ul> -<li> -<a href="./getinvolved.html">Overview</a> -</li> -<li> -<a href="./svn.html">SVN Repositories</a> -</li> -<li> -<a href="./ci.html">Buildbot</a> -</li> -<li> -<a href="https://reviews.apache.org/groups/tomcat/">Reviewboard</a> -</li> -<li> -<a href="./tools.html">Tools</a> -</li> -</ul> -<p> -<strong>Media</strong> -</p> -<ul> -<li> -<a href="http://blogs.apache.org/tomcat/">Blog</a> -</li> -<li> -<a href="http://twitter.com/theapachetomcat">Twitter</a> -</li> -</ul> -<p> -<strong>Misc</strong> -</p> -<ul> -<li> -<a href="./whoweare.html">Who We Are</a> -</li> -<li> -<a href="./heritage.html">Heritage</a> -</li> -<li> -<a href="http://www.apache.org">Apache Home</a> -</li> -<li> -<a href="./resources.html">Resources</a> -</li> -<li> -<a href="./contact.html">Contact</a> -</li> -<li> -<a href="./legal.html">Legal</a> -</li> -<li> -<a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a> -</li> -<li> -<a href="http://www.apache.org/foundation/thanks.html">Thanks</a> -</li> -</ul> -</td> -<!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left" id="mainBody"> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Table of Contents"> -<!--()--></a><a name="Table_of_Contents"><strong>Table of Contents</strong></a></font></td> -</tr> -<tr> -<td> -<p> -<blockquote> - -<ul> -<li> -<a href="#Before_you_report_a_bug">Before you report a bug</a> -<ol> -<li> -<a href="#Bugzilla_is_not_a_support_forum">Bugzilla is not a support forum</a> -</li> -</ol> -</li> -<li> -<a href="#Resources_to_help_resolve_Apache_Tomcat_problems">Resources to help resolve Apache Tomcat problems</a> -<ol> -<li> -<a href="#Problem_troubleshooting">Problem troubleshooting</a> -</li> -<li> -<a href="#Apache_Tomcat_discussion_lists">Apache Tomcat discussion lists</a> -</li> -<li> -<a href="#Known_issues">Known issues</a> -</li> -<li> -<a href="#Recent_version">Recent version</a> -</li> -</ol> -</li> -<li> -<a href="#Looking_for_known_issues">Looking for known issues</a> -<ol> -<li> -<a href="#Search_the_bug_database">Search the bug database</a> -</li> -<li> -<a href="#Changelog">Changelog</a> -</li> -<li> -<a href="#Third_party_components">Third party components</a> -</li> -</ol> -</li> -<li> -<a href="#Reporting_Apache_Tomcat_bugs">Reporting Apache Tomcat bugs</a> -<ol> -<li> -<a href="#How_to_write_a_bug_report">How to write a bug report</a> -</li> -<li> -<a href="#How_to_submit_patches_and_enhancement_requests">How to submit patches and enhancement requests</a> -</li> -<li> -<a href="#Security_Issues">Security Issues</a> -</li> -</ol> -</li> -</ul> - -</blockquote> -</p> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Before you report a bug"> -<!--()--></a><a name="Before_you_report_a_bug"><strong>Before you report a bug</strong></a></font></td> -</tr> -<tr> -<td> -<p> -<blockquote> - +<!DOCTYPE html SYSTEM "about:legacy-compat"> +<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><link href="stylesheets/tomcat.css" rel="stylesheet" type="text/css"><link href="stylesheets/tomcat-printer.css" rel="stylesheet" type="text/css" media="print"><title>Apache Tomcat - Reporting Bugs</title><meta name="author" content="Glenn L. Nielsen"></head><body><div id="wrapper"><header id="header"><div><div><div class="logo noPrint"><a href=""><img alt="Tomcat Home" src="./images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo"><a href="http://www.apache.org/" target="_blank"><img src="http://www.apache.org/images/feather.png" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1 style="margin-top: 35px;">Apache Tomcat</h1><div style="clear: right;"></div><div class="searchbox noPrint"><form action="http://www.google.com/search" method="get"><input value="tomcat.apache.org" name="sitesearch" type="hidden"><input placeholder="Search t he Site…" required="required" size="25" name="q" id="query" type="search"><button>Search</button></form></div><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2><strong>Apache Tomcat</strong></h2><ul><li><a href="./index.html">Home</a></li><li><a href="./taglibs/">Taglibs</a></li><li><a href="./maven-plugin.html">Maven Plugin</a></li></ul></div><div><h2><strong>Download</strong></h2><ul><li><a href="./whichversion.html">Which version?</a></li><li><a href="./download-80.cgi">Tomcat 8.0</a></li><li><a href="./download-70.cgi">Tomcat 7.0</a></li><li><a href="./download-60.cgi">Tomcat 6.0</a></li><li><a href="./download-connectors.cgi">Tomcat Connectors</a></li><li><a href="./download-native.cgi">Tomcat Native</a></li><li><a href="http://archive.apache.org/dist/tomcat/">Archives</a></li></ul></div><div><h2><strong>Documentation</strong></h2><ul><li><a href="./tomcat-8.0-d oc/index.html">Tomcat 8.0</a></li><li><a href="./tomcat-7.0-doc/index.html">Tomcat 7.0</a></li><li><a href="./tomcat-6.0-doc/index.html">Tomcat 6.0</a></li><li><a href="./connectors-doc/">Tomcat Connectors</a></li><li><a href="./native-doc/">Tomcat Native</a></li><li><a href="http://wiki.apache.org/tomcat/FrontPage">Wiki</a></li><li><a href="./migration.html">Migration Guide</a></li></ul></div><div><h2><strong>Problems?</strong></h2><ul><li><a href="./security.html">Security Reports</a></li><li><a href="./findhelp.html">Find help</a></li><li><a href="http://wiki.apache.org/tomcat/FAQ">FAQ</a></li><li><a href="./lists.html">Mailing Lists</a></li><li><a href="./bugreport.html">Bug Database</a></li><li><a href="./irc.html">IRC</a></li></ul></div><div><h2><strong>Get Involved</strong></h2><ul><li><a href="./getinvolved.html">Overview</a></li><li><a href="./svn.html">SVN Repositories</a></li><li><a href="./ci.html">Buildbot</a></li><li><a href="https://reviews.apache.org/groups/tomcat/"> Reviewboard</a></li><li><a href="./tools.html">Tools</a></li></ul></div><div><h2><strong>Media</strong></h2><ul><li><a href="http://blogs.apache.org/tomcat/">Blog</a></li><li><a href="http://twitter.com/theapachetomcat">Twitter</a></li></ul></div><div><h2><strong>Misc</strong></h2><ul><li><a href="./whoweare.html">Who We Are</a></li><li><a href="./heritage.html">Heritage</a></li><li><a href="http://www.apache.org">Apache Home</a></li><li><a href="./resources.html">Resources</a></li><li><a href="./contact.html">Contact</a></li><li><a href="./legal.html">Legal</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li></ul></div></nav></div></div><div id="mainRight"><div id="content"><main><h2 style="display: none;">Content</h2><h3 id="Table_of_Contents">Table of Contents</h3><div class="text"> +<ul><li><a href="#Before_you_report_a_bug">Before you report a bug</a><ol><li><a href="#Bugzilla_is_not_a_support_forum">Bugzilla is not a support forum</a></li></ol></li><li><a href="#Resources_to_help_resolve_Apache_Tomcat_problems">Resources to help resolve Apache Tomcat problems</a><ol><li><a href="#Problem_troubleshooting">Problem troubleshooting</a></li><li><a href="#Apache_Tomcat_discussion_lists">Apache Tomcat discussion lists</a></li><li><a href="#Known_issues">Known issues</a></li><li><a href="#Recent_version">Recent version</a></li></ol></li><li><a href="#Looking_for_known_issues">Looking for known issues</a><ol><li><a href="#Search_the_bug_database">Search the bug database</a></li><li><a href="#Changelog">Changelog</a></li><li><a href="#Third_party_components">Third party components</a></li></ol></li><li><a href="#Reporting_Apache_Tomcat_bugs">Reporting Apache Tomcat bugs</a><ol><li><a href="#How_to_write_a_bug_report">How to write a bug report</a></li><li><a href="#How_ to_submit_patches_and_enhancement_requests">How to submit patches and enhancement requests</a></li><li><a href="#Security_Issues">Security Issues</a></li></ol></li></ul> +</div><h3 id="Before_you_report_a_bug">Before you report a bug</h3><div class="text"> <p>The Apache Tomcat community consists of those who use Apache Tomcat, help answer questions on discussions lists, contribute documentation and patches, and those who develop and maintain the code for Apache Tomcat. Almost all those who assist on a day to day basis resolving bug reports do this for a wide variety of reasons, and almost all of them do this on their own time.</p> - <p>Many bugs reported end up not being a bug in the Apache Tomcat code, but are due to misconfiguration, problems caused by installed applications, the operating system, etc.</p> - <div style="margin-left: 2em"> - -<p> -<b>Before reporting a bug please make every effort to resolve the problem - yourself.</b> -</p> + <p><b>Before reporting a bug please make every effort to resolve the problem + yourself.</b></p> - -<p>If you need help, ask on the <b>users</b> + <p>If you need help, ask on the <b>users</b> <a href="lists.html">mailing list</a>.</p> - </div> - <p>The remainder of this document points you toward resources you can use to resolve the problem you are having. </p> - -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Bugzilla is not a support forum"> -<!--()--></a><a name="Bugzilla_is_not_a_support_forum"><strong>Bugzilla is not a support forum</strong></a></font></td> -</tr> -<tr> -<td> -<blockquote> - -<p>Bugzilla is a tool to track bug reports and feature requests. It is used + <div class="subsection"><h4 id="Bugzilla_is_not_a_support_forum">Bugzilla is not a support forum</h4><div class="text"> + <p>Bugzilla is a tool to track bug reports and feature requests. It is used to <b>organize</b> work on Apache Tomcat projects, so that such issues are not forgotten and to document how they were resolved. </p> - -<p>Bugzilla <b>is not</b> a place to ask questions on how to configure your + <p>Bugzilla <b>is not</b> a place to ask questions on how to configure your own system, or how to interpret some error message or behaviour that you do not understand. If you have questions, please ask on the <b>users</b> <a href="lists.html">mailing list</a>. </p> - -<p>When you have gathered enough information to diagnose your problem, + <p>When you have gathered enough information to diagnose your problem, and it is indeed a bug that can be fixed in Apache Tomcat, feel free to create or reopen your Bugzilla issue for it. You can find a link to your discussion in the <a href="lists.html">mailing list archives</a> and include it in your bug report. </p> - -</blockquote> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> - -</blockquote> -</p> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Resources to help resolve Apache Tomcat problems"> -<!--()--></a><a name="Resources_to_help_resolve_Apache_Tomcat_problems"><strong>Resources to help resolve Apache Tomcat problems</strong></a></font></td> -</tr> -<tr> -<td> -<p> -<blockquote> - + </div></div> +</div><h3 id="Resources_to_help_resolve_Apache_Tomcat_problems">Resources to help resolve Apache Tomcat problems</h3><div class="text"> <p>Here are some resources you can use to help you resolve the problem you are having before reporting a bug.</p> - -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Problem troubleshooting"> -<!--()--></a><a name="Problem_troubleshooting"><strong>Problem troubleshooting</strong></a></font></td> -</tr> -<tr> -<td> -<blockquote> - -<p> - -<li> -<b>Documentation</b> – Review the documentation for the version + <div class="subsection"><h4 id="Problem_troubleshooting">Problem troubleshooting</h4><div class="text"> + <p> + <li><b>Documentation</b> – Review the documentation for the version of Apache Tomcat that you are using. The problem that you are facing may already be addressed in the docs. Note, that documentation is searchable.</li> - -<li> -<b>Logs</b> – The logs which Apache Tomcat generates can be a valuable + <li><b>Logs</b> – The logs which Apache Tomcat generates can be a valuable resource when trying to diagnose a problem. Please review them. You may want to enable debug output in your Apache Tomcat configuration so that you have more information to help diagnose the problem. You may want to configure an Access Log (a valve) to log what requests reached Tomcat and what was Tomcat's response to them. </li> - -<li> -<b>Wiki</b> – Search the + <li><b>Wiki</b> – Search the <a href="http://wiki.apache.org/tomcat/FrontPage">Wiki</a>. That is unofficial documentation to which everyone can contribute. </li> - -<li> -<b>FAQ's</b> – Search the <a href="http://wiki.apache.org/tomcat/FAQ"> + <li><b>FAQ's</b> – Search the <a href="http://wiki.apache.org/tomcat/FAQ"> Tomcat Frequently Asked Questions</a> that is part of the Wiki.</li> - -</p> - -</blockquote> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> - - -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Apache Tomcat discussion lists"> -<!--()--></a><a name="Apache_Tomcat_discussion_lists"><strong>Apache Tomcat discussion lists</strong></a></font></td> -</tr> -<tr> -<td> -<blockquote> - -<p>It is very likely you are not the first to run into a problem. + </p> + </div></div> + + <div class="subsection"><h4 id="Apache_Tomcat_discussion_lists">Apache Tomcat discussion lists</h4><div class="text"> + <p>It is very likely you are not the first to run into a problem. Others may have already found a solution. The mailing list archives may contain discussions which will help you resolve the problem. </p> - -<p>See the <a href="lists.html">mailing lists</a> page for the further + <p>See the <a href="lists.html">mailing lists</a> page for the further information on the lists.</p> - -<p>See also the <a href="findhelp.html">Find help</a> page.</p> - -</blockquote> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> - - -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Known issues"> -<!--()--></a><a name="Known_issues"><strong>Known issues</strong></a></font></td> -</tr> -<tr> -<td> -<blockquote> - -<p>Please search the bug database to see if the bug you are seeing has + <p>See also the <a href="findhelp.html">Find help</a> page.</p> + </div></div> + + <div class="subsection"><h4 id="Known_issues">Known issues</h4><div class="text"> + <p>Please search the bug database to see if the bug you are seeing has already been reported. Please look at the changelog page for the bugs that have already been fixed. The changelogs for not-yet-released versions of Tomcat are also available. More details are below. </p> - -</blockquote> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> - - -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Recent version"> -<!--()--></a><a name="Recent_version"><strong>Recent version</strong></a></font></td> -</tr> -<tr> -<td> -<blockquote> - -<p>Try to reproduce your problem with the latest released version of + </div></div> + + <div class="subsection"><h4 id="Recent_version">Recent version</h4><div class="text"> + <p>Try to reproduce your problem with the latest released version of Apache Tomcat.</p> - -</blockquote> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> + </div></div> +</div><h3 id="Looking_for_known_issues">Looking for known issues</h3><div class="text"> -</blockquote> -</p> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Looking for known issues"> -<!--()--></a><a name="Looking_for_known_issues"><strong>Looking for known issues</strong></a></font></td> -</tr> -<tr> -<td> -<p> -<blockquote> - - -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Search the bug database"> -<!--()--></a><a name="Search_the_bug_database"><strong>Search the bug database</strong></a></font></td> -</tr> -<tr> -<td> -<blockquote> - -<p>Please search the bug database to see if the bug you are + <div class="subsection"><h4 id="Search_the_bug_database">Search the bug database</h4><div class="text"> + <p>Please search the bug database to see if the bug you are seeing has already been reported. </p> - -<ul> - -<li>The bug may have already been fixed and is available in a later + <ul> + <li>The bug may have already been fixed and is available in a later version or nightly build.</li> - -<li>Someone else may have reported the bug, you could add supporting + <li>Someone else may have reported the bug, you could add supporting information to help reproduce and resolve the bug.</li> - -</ul> - -<p>The search page is + </ul> + <p>The search page is <a href="https://issues.apache.org/bugzilla/query.cgi">here</a>. There is also <a href="https://issues.apache.org/bugzilla/query.cgi?format=advanced">advanced</a> search page. </p> - -<p>Here are some search tips.</p> - -<ol> - -<li> -<p>Search for closed bugs as well as for the open ones.</p> - -<p>On the advanced search page you can clear the "Status" field to + <p>Here are some search tips.</p> + <ol> + <li><p>Search for closed bugs as well as for the open ones.</p> + <p>On the advanced search page you can clear the "Status" field to avoid filtering by status.</p> - -</li> - -<li> -<p>Search across different versions of Tomcat.</p> - -<p>In the bug database Tomcat is represented by several "products". + </li> + <li><p>Search across different versions of Tomcat.</p> + <p>In the bug database Tomcat is represented by several "products". The same problem should be reported only once, but the fix may be applied to different Tomcat versions. While doing so, the bug report is moved between different products. A bug that is originally reported against Tomcat 8 is moved to Tomcat 7 and maybe later to Tomcat 6. So it makes sense to search all the versions at once.</p> - -<p>Here is a quick list of supported products:</p> - -<ul> - -<li> -<b>Tomcat 8</b>, <b>Tomcat 7</b> and <b>Tomcat 6</b> – + <p>Here is a quick list of supported products:</p> + <ul> + <li><b>Tomcat 8</b>, <b>Tomcat 7</b> and <b>Tomcat 6</b> – Tomcat 8.0.x, 7.0.x and 6.0.x</li> - -<li> -<b>Tomcat Connectors</b> – Integration of Tomcat with other Web servers</li> - -<li> -<b>Tomcat Native</b> – APR based native HTTP and AJP connectors for Tomcat</li> - -<li> -<b>Tomcat Modules</b> – Additional Tomcat components</li> - -<li> -<b>Taglibs</b> – Apache <a href="/taglibs/">Taglibs</a> subproject</li> - -</ul> - - -</li> - -<li> -<p>Search not only Summary field, but also the Comment one</p> - -<p>On the advanced search page open "Detailed Bug Information", + <li><b>Tomcat Connectors</b> – Integration of Tomcat with other Web servers</li> + <li><b>Tomcat Native</b> – APR based native HTTP and AJP connectors for Tomcat</li> + <li><b>Tomcat Modules</b> – Additional Tomcat components</li> + <li><b>Taglibs</b> – Apache <a href="/taglibs/">Taglibs</a> subproject</li> + </ul> + + </li> + <li><p>Search not only Summary field, but also the Comment one</p> + <p>On the advanced search page open "Detailed Bug Information", then type your query into the "Comment" field. </p> - -</li> - -<li> -<p>You can limit results to the issues that were changed recently.</p> - -<p>On the advanced search page open "Search by Change History", + </li> + <li><p>You can limit results to the issues that were changed recently.</p> + <p>On the advanced search page open "Search by Change History", then type "<code>-2m</code>" into the first field in the pair of "between" fields to limit results to the issues changed in the last 2 months.</p> - -</li> - -<li> -<p>Some bugs do not belong to Tomcat.</p> - -<p>Tomcat bundles libraries from several other projects. You can see + </li> + <li><p>Some bugs do not belong to Tomcat.</p> + <p>Tomcat bundles libraries from several other projects. You can see RELEASE-NOTES and NOTICE files in your distribution for details. More details are in a separate section below.</p> - -</li> - -</ol> - -</blockquote> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> - - -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Changelog"><strong>Changelog</strong></a></font></td> -</tr> -<tr> -<td> -<blockquote> + </li> + </ol> + </div></div> - -<p>If you are looking for the recently fixed issues there are several + <div class="subsection"><h4 id="Changelog">Changelog</h4><div class="text"> + + <p>If you are looking for the recently fixed issues there are several places to look at.</p> - -<ul> - -<li> -<p>Changelog files for released versions</p> - -<p>These are published on the Tomcat website.</p> - -</li> - -<li> -<p>Changelog files for <em>not-yet-released</em> versions</p> - -<p>These are available in the source code.</p> - -<p>They are in XML format with style sheets attached. Thus + <ul> + <li><p>Changelog files for released versions</p> + <p>These are published on the Tomcat website.</p> + </li> + <li><p>Changelog files for <em>not-yet-released</em> versions</p> + <p>These are available in the source code.</p> + <p>They are in XML format with style sheets attached. Thus modern web browsers can display them nicely.</p> - -<p>The files are also available in nightly documentation builds. + <p>The files are also available in nightly documentation builds. See <a href="ci.html">Buildbot</a> page for details.</p> - -</li> - -<li> -<p>STATUS files for Tomcat 7 and Tomcat 6</p> - -<p>These are available in the source code. These files are + </li> + <li><p>STATUS files for Tomcat 7 and Tomcat 6</p> + <p>These are available in the source code. These files are used in Review-Then-Commit development process to propose and then vote for the proposed patches.</p> - -</li> - -</ul> - - -<p>Links:</p> - - -<table> - -<tr> - -<th><strong>Product</strong></th> + </li> + </ul> + + <p>Links:</p> + + <table> + <tr> + <th><strong>Product</strong></th> <th><strong>Changelog (released)</strong></th> <th><strong>Changelog (unreleased)</strong></th> <th><strong>STATUS</strong></th> - -</tr> + </tr> - -<tr> - -<td>Tomcat 8.0 (trunk)</td> + <tr> + <td>Tomcat 8.0 (trunk)</td> <td> <a href="http://tomcat.apache.org/tomcat-8.0-doc/changelog.html">changelog.html</a> </td> @@ -703,13 +196,10 @@ problem you are having before reporting <a href="http://svn.apache.org/repos/asf/tomcat/trunk/webapps/docs/changelog.xml">changelog.xml</a> </td> <td><i>none</i></td> - -</tr> + </tr> - -<tr> - -<td>Tomcat 7.0</td> + <tr> + <td>Tomcat 7.0</td> <td> <a href="http://tomcat.apache.org/tomcat-7.0-doc/changelog.html">changelog.html</a> </td> @@ -717,13 +207,10 @@ problem you are having before reporting <a href="http://svn.apache.org/repos/asf/tomcat/tc7.0.x/trunk/webapps/docs/changelog.xml">changelog.xml</a> </td> <td><i>none</i></td> - -</tr> + </tr> - -<tr> - -<td>Tomcat 6.0</td> + <tr> + <td>Tomcat 6.0</td> <td> <a href="http://tomcat.apache.org/tomcat-6.0-doc/changelog.html">changelog.html</a> </td> @@ -733,13 +220,10 @@ problem you are having before reporting <td> <a href="http://svn.apache.org/viewvc/tomcat/tc6.0.x/trunk/STATUS.txt?view=markup">STATUS.txt</a> </td> - -</tr> + </tr> - -<tr> - -<td>Tomcat Connectors</td> + <tr> + <td>Tomcat Connectors</td> <td> <a href="http://tomcat.apache.org/connectors-doc/miscellaneous/changelog.html">changelog.html</a> </td> @@ -747,13 +231,10 @@ problem you are having before reporting <a href="http://svn.apache.org/repos/asf/tomcat/jk/trunk/xdocs/miscellaneous/changelog.xml">changelog.xml</a> </td> <td><i>none</i></td> - -</tr> + </tr> - -<tr> - -<td>Tomcat Native</td> + <tr> + <td>Tomcat Native</td> <td> <a href="http://tomcat.apache.org/native-doc/miscellaneous/changelog.html">changelog.html</a> </td> @@ -761,435 +242,192 @@ problem you are having before reporting <a href="http://svn.apache.org/repos/asf/tomcat/native/branches/1.1.x/xdocs/miscellaneous/changelog.xml">changelog.xml</a> </td> <td><i>none</i></td> - -</tr> - -</table> - -</blockquote> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> - - -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Third party components"> -<!--()--></a><a name="Third_party_components"><strong>Third party components</strong></a></font></td> -</tr> -<tr> -<td> -<blockquote> - -<p>Tomcat bundles libraries from several other projects. See + </tr> + </table> + </div></div> + + <div class="subsection"><h4 id="Third_party_components">Third party components</h4><div class="text"> + <p>Tomcat bundles libraries from several other projects. See RELEASE-NOTES and NOTICE files in your distribution for details. The versions of the components that were used to build Tomcat are defined in the <code>build.properties.default</code> file in the source distribution.</p> - -<p>Notable components are:</p> - -<ul> - -<li> -<p>Tomcat service launcher – + <p>Notable components are:</p> + <ul> + <li><p>Tomcat service launcher – <code>commons-daemon-*</code>, <code>tomcatN.exe</code>, <code>tomcatNw.exe</code> - -</p> - -<p>The service launcher is provided by + </p> + <p>The service launcher is provided by <a href="http://commons.apache.org/daemon/">Apache Commons Daemon</a> project.</p> - -<p>Using the terminology from that project, the *nixes launcher is + <p>Using the terminology from that project, the *nixes launcher is called <code>jsvc</code> and the Windows launcher is called <code>procrun</code>. The <code>tomcatN.exe</code> and <code>tomcatNw.exe</code> programs in Tomcat distributions are just renamed <code>prunsrv.exe</code> and <code>prunmgr.exe</code> from Apache Commons Daemon binaries distribution. </p> - -</li> + </li> - -<li> -<p>DBCP Database Pool implementation – + <li><p>DBCP Database Pool implementation – <code>tomcat-dbcp.jar</code>. </p> - -<p>This pool implementation is provided by + <p>This pool implementation is provided by <a href="http://commons.apache.org/pool/">Apache Commons Pool</a> and <a href="http://commons.apache.org/dbcp/">Apache Commons DBCP</a> projects.</p> - -<p>The classes from these two projects are renamed into a different + <p>The classes from these two projects are renamed into a different package, to avoid conflicts if the same libraries are used by web - applications, recompiled and packed into a single JAR file.</p> -</li> + applications, recompiled and packed into a single JAR file.</p></li> - -<li> -<p>JDBC Database Pool implementation – + <li><p>JDBC Database Pool implementation – <code>tomcat-jdbc.jar</code>. </p> - -<p>This pool implementation is available with Tomcat 7 and + <p>This pool implementation is available with Tomcat 7 and it comes from <b>jdbc-pool</b> project that is part of <b>Tomcat Modules</b>. This library is developed alongside the main Tomcat. </p> - -</li> + </li> - -<li> -<p>Tomcat + <li><p>Tomcat <a href="http://tomcat.apache.org/maven-plugin.html">Maven plugin</a> subproject tracks its issues in <a href="https://issues.apache.org/jira/browse/MTOMCAT">JIRA database</a>. </p> - -</li> + </li> - -</ul> - -</blockquote> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> - - -</blockquote> -</p> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Reporting Apache Tomcat bugs"> -<!--()--></a><a name="Reporting_Apache_Tomcat_bugs"><strong>Reporting Apache Tomcat bugs</strong></a></font></td> -</tr> -<tr> -<td> -<p> -<blockquote> + </ul> + </div></div> +</div><h3 id="Reporting_Apache_Tomcat_bugs">Reporting Apache Tomcat bugs</h3><div class="text"> <p>Please make sure the problem is a bug in Apache Tomcat and not a bug in your web application.</p> - <p>Note, that <a href="security.html">security-related</a> issues should <b>not</b> be reported through Bugzilla.</p> - -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="How to write a bug report"> -<!--()--></a><a name="How_to_write_a_bug_report"><strong>How to write a bug report</strong></a></font></td> -</tr> -<tr> -<td> -<blockquote> - -<p>Please provide as much information as possible. It is + <div class="subsection"><h4 id="How_to_write_a_bug_report">How to write a bug report</h4><div class="text"> + <p>Please provide as much information as possible. It is very hard to fix a bug if the person looking into the problem cannot reproduce it. See also <a href="https://issues.apache.org/bugzilla/page.cgi?id=bug-writing.html">Bug Writing Guidelines</a>. </p> - -<p>Bug submission starts + <p>Bug submission starts <a href="https://issues.apache.org/bugzilla/enter_bug.cgi">here</a>. You have to include the following information in your bug report:</p> - -<ul> - -<li> -<p> -<b>Product</b>. Here is a list of supported products:</p> - -<ul> - -<li> -<b>Tomcat 8</b> – Tomcat 8.0.x and tomcat.apache.org web site</li> - -<li> -<b>Tomcat 7</b> – Tomcat 7.0.x</li> - -<li> -<b>Tomcat 6</b> – Tomcat 6.0.x</li> - -<li> -<b>Tomcat Connectors</b> – Integration of Tomcat with other Web servers. + <ul> + <li><p><b>Product</b>. Here is a list of supported products:</p> + <ul> + <li><b>Tomcat 8</b> – Tomcat 8.0.x and tomcat.apache.org web site</li> + <li><b>Tomcat 7</b> – Tomcat 7.0.x</li> + <li><b>Tomcat 6</b> – Tomcat 6.0.x</li> + <li><b>Tomcat Connectors</b> – Integration of Tomcat with other Web servers. The <b>mod_jk</b> module for <a href="http://httpd.apache.org/">Apache HTTPD</a> and other web servers.</li> - -<li> -<b>Tomcat Native</b> – HTTP and AJP connectors for Tomcat + <li><b>Tomcat Native</b> – HTTP and AJP connectors for Tomcat using native code and linked with Apache APR and OpenSSL libraries</li> - -<li> -<b>Tomcat Modules</b> – Additional Tomcat components, such as <b>jdbc-pool</b> -</li> - -<li> -<b>Taglibs</b> – Apache <a href="/taglibs/">Taglibs</a> subproject</li> - -</ul> - -</li> - -<li> -<p> -<b>Version</b> – Apache Tomcat version.</p> - -<p>Please not only select it from the list, but also mention it in + <li><b>Tomcat Modules</b> – Additional Tomcat components, such as <b>jdbc-pool</b></li> + <li><b>Taglibs</b> – Apache <a href="/taglibs/">Taglibs</a> subproject</li> + </ul> + </li> + <li><p><b>Version</b> – Apache Tomcat version.</p> + <p>Please not only select it from the list, but also mention it in your text. The bug description can be updated, so it is important to mention the version in the text as well. - </p> -</li> - -<li> -<p> -<b>Component</b> – The component which has the bug.</p> - -<p>If you do not know, just guess.</p> -</li> - -<li> -<p> -<b>Platform</b> and <b>OS</b> – Hardware platform and - operating system Tomcat is running on.</p> -</li> - -<li> -<p> -<b>Severity</b> – This is <code>normal</code> for usual + </p></li> + <li><p><b>Component</b> – The component which has the bug.</p> + <p>If you do not know, just guess.</p></li> + <li><p><b>Platform</b> and <b>OS</b> – Hardware platform and + operating system Tomcat is running on.</p></li> + <li><p><b>Severity</b> – This is <code>normal</code> for usual bug reports and <code>enhancement</code> for enhancement requests.</p> - -<p>If you tend to mark it as <code>critical</code>, you are probably + <p>If you tend to mark it as <code>critical</code>, you are probably doing it wrong. It is likely that the issue is already known and fixed, or it is not an issue at all.</p> - -</li> - -<li> -<p>Configuration details</p> - -<p>Please mention these in your text:</p> - -<ul> - -<li>Java version – Vendor and version of your Java + </li> + <li><p>Configuration details</p> + <p>Please mention these in your text:</p> + <ul> + <li>Java version – Vendor and version of your Java Runtime Environment used to run Tomcat.</li> - -<li>If Tomcat is used behind + <li>If Tomcat is used behind <a href="http://httpd.apache.org/">Apache HTTPD</a> or other web server – its version and how it is configured.</li> - -<li>Tomcat Connector that is being used. + <li>Tomcat Connector that is being used. There are several implementations of Connectors in Tomcat. Which one is being used is shown in the logs during Tomcat startup. </li> - -</ul> - -</li> - -<li> -<p>Attachments</p> - -<p>Attach configuration files and Tomcat log files if they would help + </ul> + </li> + <li><p>Attachments</p> + <p>Attach configuration files and Tomcat log files if they would help to track down the bug.</p> - -</li> - -<li> -<p>Reproducer</p> - -<p>Please describe how to reproduce your problem on a clean Tomcat + </li> + <li><p>Reproducer</p> + <p>Please describe how to reproduce your problem on a clean Tomcat installation. If you can please provide a <b>simple</b> sample web application that demonstrates the issue. </p> - -</li> - -</ul> - -</blockquote> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> - - -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="How to submit patches and enhancement requests"> -<!--()--></a><a name="How_to_submit_patches_and_enhancement_requests"><strong>How to submit patches and enhancement requests</strong></a></font></td> -</tr> -<tr> -<td> -<blockquote> - -<p>Enhancement requests for Tomcat are submitted using the same procedure + </li> + </ul> + </div></div> + + <div class="subsection"><h4 id="How_to_submit_patches_and_enhancement_requests">How to submit patches and enhancement requests</h4><div class="text"> + <p>Enhancement requests for Tomcat are submitted using the same procedure as bug reports, but in the <b>Severity</b> field you will select the value "<code>enhancement</code>". </p> - -<p>To propose a patch, attach it to a Bugzilla issue. Any patches are welcome, + <p>To propose a patch, attach it to a Bugzilla issue. Any patches are welcome, but we prefer the ones that use the <a href="http://en.wikipedia.org/wiki/Diff#Unified_format" rel="nofollow"> Unified Diff</a> format. Those can be generated using <code>diff -u</code> command or <code>svn diff</code> command. </p> - -<p>When providing a patch, please mention to which version of the sources it + <p>When providing a patch, please mention to which version of the sources it applies.</p> - -<p>Here are some references:</p> - -<ul> - -<li> -<p>Regarding Apache Tomcat:</p> - -<ul> - -<li> -<a href="svn.html">Subversion repository structure</a> of Apache Tomcat</li> - -<li>Read BUILDING.txt in the source distribution</li> - -</ul> - -</li> - -<li> -<p>Apache Software Foundation guildelines:</p> - -<ul> - -<li>General <a href="http://www.apache.org/dev/version-control.html#anon-svn">Apache - guidance for Subversion</a> -</li> - -<li>Sending in Patches chapter of - <a href="http://www.apache.org/dev/contributors.html#patches">Contributors Tech Guide</a> -</li> - -</ul> - -</li> - -<li> -<p>General Subversion documentation:</p> - -<ul> - -<li>The <a href="http://svnbook.red-bean.com/index.en.html">Subversion Book</a> -</li> - -</ul> - -</li> - -</ul> - -</blockquote> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> - - -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica,sanserif"><a name="Security Issues"> -<!--()--></a><a name="Security_Issues"><strong>Security Issues</strong></a></font></td> -</tr> -<tr> -<td> -<blockquote> + <p>Here are some references:</p> + <ul> + <li><p>Regarding Apache Tomcat:</p> + <ul> + <li><a href="svn.html">Subversion repository structure</a> of Apache Tomcat</li> + <li>Read BUILDING.txt in the source distribution</li> + </ul> + </li> + <li><p>Apache Software Foundation guildelines:</p> + <ul> + <li>General <a href="http://www.apache.org/dev/version-control.html#anon-svn">Apache + guidance for Subversion</a></li> + <li>Sending in Patches chapter of + <a href="http://www.apache.org/dev/contributors.html#patches">Contributors Tech Guide</a></li> + </ul> + </li> + <li><p>General Subversion documentation:</p> + <ul> + <li>The <a href="http://svnbook.red-bean.com/index.en.html">Subversion Book</a></li> + </ul> + </li> + </ul> + </div></div> +<div class="subsection"><h4 id="Security_Issues">Security Issues</h4><div class="text"> <p>Security-related bugs are of special concern. If you have a verified security bug to report please neither post it to public email lists nor submit a bug report. See <a href="security.html">Security Reports</a> page on how to report them.</p> +</div></div> -</blockquote> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> - - -</blockquote> -</p> -</td> -</tr> -<tr> -<td> -<br> -</td> -</tr> -</table> -</td> -</tr> -<!--FOOTER SEPARATOR--> -<tr> -<td colspan="2"> -<hr noshade size="1"> -</td> -</tr> -<!--PAGE FOOTER--> -<tr> -<td colspan="2"> -<div align="center"> -<font color="#525D76" size="-1"><em> - Copyright © 1999-2013, The Apache Software Foundation - <br> - Apache Tomcat, Tomcat, Apache, the Apache feather, and the Apache Tomcat - project logo are trademarks of the Apache Software Foundation. - </em></font> -</div> -</td> -</tr> -</table> -</body> -</html> +</div></main></div></div></div></div><footer id="footer"> + Copyright © 1999-2013, The Apache Software Foundation + <br> + Apache Tomcat, Tomcat, Apache, the Apache feather, and the Apache Tomcat + project logo are trademarks of the Apache Software Foundation. + </footer></div></body></html> \ No newline at end of file --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org