<title>Reporting Bugs</title>
<link rel=stylesheet href="../webkitdev.css">
<script type="text/javascript">
- /*
- Copyright (C) 2006 Joost de Valk, http://www.joostdevalk.nl/. All rights reserved.
- Copyright (C) 2006 Mark Rowe, http://bdash.net.nz/. All rights reserved.
- Copyright (C) 2006 Apple Computer, Inc. All rights reserved.
-
- Redistribution and use in source and binary forms, with or without
- modification, are permitted provided that the following conditions
- are met:
- 1. Redistributions of source code must retain the above copyright
- notice, this list of conditions and the following disclaimer.
- 2. Redistributions in binary form must reproduce the above copyright
- notice, this list of conditions and the following disclaimer in the
- documentation and/or other materials provided with the distribution.
-
- THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
- EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
- PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR
- CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
- EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
- PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
- PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
- OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
- Script used for recognizing Safari / WebKit. A matrix of these versions can
- be found at: http://developer.apple.com/internet/safari/uamatrix.html .
- */
- function parse_version(version)
- {
- var bits = version.split(".");
- var is_nightly = (version[version.length - 1] == "+");
- return {major: parseInt(bits[0]), minor: parseInt(bits[1]), is_nightly: is_nightly};
- }
-
- function display(id, display_style)
- {
- document.getElementById(id).style.display = display_style;
- }
-
- function get_version()
- {
- var regex = new RegExp("Mozilla/5.0 \\(.*\\) AppleWebKit/(.*) \\(KHTML, like Gecko\\) Safari/(.*)");
- var matches = regex.exec(navigator.userAgent);
- if (! matches)
- return;
-
- // We have detected a safari version, hide the unknown version text
- display('unknown_version', 'none');
- var webkit_version = parse_version(matches[1]);
- var safari_version = parse_version(matches[2]);
-
-
- if (safari_version.major < 100)
- // Mac OS X 10.2
- display('10point2', 'block');
-
-
- else if (safari_version.major >= 100 && safari_version.major < 400)
- {
- // Mac OS X 10.3
- display('10point3', 'block');
-
- if (safari_version.major < 312)
- // Mac OS X 10.3.8 or lower
- display('updateto10_3_9', 'block');
-
- else if (safari_version.minor < 5)
- // Mac OS X 10.3.9 but not the latest Safari update
- display('update10_3_9_safari', 'block');
-
- else
- // Mac OS X 10.3.9 with the latest Safari update
- display('best10_3_9_safari', 'block');
-
-
- } else {
- // Mac OS X 10.4
- display('10point4', 'block');
-
- if (webkit_version.major == 412 && webkit_version.is_nightly)
- // Using an old nightly
- display('neednewnightly', 'block');
-
- else if (webkit_version.major == 420 && webkit_version.is_nightly)
- // Using a recent nightly, not sure which
- display('mightneednewnightly', 'block');
-
- else if (safari_version.major < 417)
- // 10.4.3 or lower
- display('updateto10_4_4', 'block');
-
- else
- // 10.4.4
- display('10_4_4', 'block');
- }
- }
+ /*
+ Copyright (C) 2006 Joost de Valk, http://www.joostdevalk.nl/. All rights reserved.
+ Copyright (C) 2006 Mark Rowe, http://bdash.net.nz/. All rights reserved.
+ Copyright (C) 2006 Apple Computer, Inc. All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+
+ THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
+ EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+ PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+ OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+ Script used for recognizing Safari / WebKit. A matrix of these versions can
+ be found at: http://developer.apple.com/internet/safari/uamatrix.html .
+ */
+ function parse_version(version)
+ {
+ var bits = version.split(".");
+ var is_nightly = (version[version.length - 1] == "+");
+ return {major: parseInt(bits[0]), minor: parseInt(bits[1]), is_nightly: is_nightly};
+ }
+
+ function display(id, display_style)
+ {
+ document.getElementById(id).style.display = display_style;
+ }
+
+ function get_version()
+ {
+ var regex = new RegExp("Mozilla/5.0 \\(.*\\) AppleWebKit/(.*) \\(KHTML, like Gecko\\) Safari/(.*)");
+ var matches = regex.exec(navigator.userAgent);
+ if (! matches)
+ return;
+
+ // We have detected a safari version, hide the unknown version text
+ display('unknown_version', 'none');
+ var webkit_version = parse_version(matches[1]);
+ var safari_version = parse_version(matches[2]);
+
+
+ if (safari_version.major < 100)
+ // Mac OS X 10.2
+ display('10point2', 'block');
+
+
+ else if (safari_version.major >= 100 && safari_version.major < 400)
+ {
+ // Mac OS X 10.3
+ display('10point3', 'block');
+
+ if (safari_version.major < 312)
+ // Mac OS X 10.3.8 or lower
+ display('updateto10_3_9', 'block');
+
+ else if (safari_version.minor < 5)
+ // Mac OS X 10.3.9 but not the latest Safari update
+ display('update10_3_9_safari', 'block');
+
+ else
+ // Mac OS X 10.3.9 with the latest Safari update
+ display('best10_3_9_safari', 'block');
+
+
+ } else {
+ // Mac OS X 10.4
+ display('10point4', 'block');
+
+ if (webkit_version.major == 412 && webkit_version.is_nightly)
+ // Using an old nightly
+ display('neednewnightly', 'block');
+
+ else if (webkit_version.major == 420 && webkit_version.is_nightly)
+ // Using a recent nightly, not sure which
+ display('mightneednewnightly', 'block');
+
+ else if (safari_version.major < 417)
+ // 10.4.3 or lower
+ display('updateto10_4_4', 'block');
+
+ else
+ // 10.4.4
+ display('10_4_4', 'block');
+ }
+ }
</script>
</head>
<body>
<li>
<strong>Check your WebKit version</strong><br>
<div id="unknown_version">
- To make sure you're not wasting your (and our) time, you should be using the latest version of WebKit before you file your bug.
- You should run at least Mac OS X 10.3.9 before filing bugs. Your WebKit version should be 312 or higher if you are on
- Panther and 417 or higher if you are on Tiger. If you're running
- Mac OS X 10.4, you could also <a href="http://nightly.webkit.org">download the latest nightly</a> build to be sure you
- have the latest version. If you've done this and you still experience the bug, go ahead to the next step.
+ To make sure you're not wasting your (and our) time, you should be using the latest version of WebKit before you file your bug.
+ You should run at least Mac OS X 10.3.9 before filing bugs. Your WebKit version should be 312 or higher if you are on
+ Panther and 417 or higher if you are on Tiger. If you're running
+ Mac OS X 10.4, you could also <a href="http://nightly.webkit.org">download the latest nightly</a> build to be sure you
+ have the latest version. If you've done this and you still experience the bug, go ahead to the next step.
</div>
<div id="10point2" style="display: none;">
- We're sorry, we do not accept bugreports anymore from people using OS X 10.2. To many bugs have been fixed since then. We advise
- you to upgrade to OS X 10.4.
+ We're sorry, we do not accept bugreports anymore from people using Mac OS X 10.2. To many bugs have been fixed since then. We advise
+ you to upgrade to Mac OS X 10.4.
</div>
<div id="10point3" style="display: none;">
- <div id="updateto10_3_9" style="display: none;">
- You are using Mac OS X 10.3.8 or lower, please before filing any bugs, upgrade to Mac OS X 10.3.9.
- </div>
- <div id="update10_3_9_safari" style="display: none;">
- You are using Mac OS X 10.3.9, but your Safari isn't the latest version. Please, before filing any bugs, upgrade your Safari.
- </div>
- <div id="best10_3_9_safari">
- You are using Mac OS X 10.3.9, and the latest version of Safari, go ahead and file your bug!
- </div>
+ <div id="updateto10_3_9" style="display: none;">
+ You are using Mac OS X 10.3.8 or lower, please before filing any bugs, upgrade to Mac OS X 10.3.9.
+ </div>
+ <div id="update10_3_9_safari" style="display: none;">
+ You are using Mac OS X 10.3.9, but your Safari isn't the latest version. Please, before filing any bugs, upgrade your Safari.
+ </div>
+ <div id="best10_3_9_safari">
+ You are using Mac OS X 10.3.9, and the latest version of Safari, go ahead and file your bug!
+ </div>
</div>
<div id="10point4" style="display: none;">
- <div id="neednewnightly" style="display: none;">
- You are already using a nightly build, which is very good! A large number of bugs has been fixed since you downloaded
- this nightly build though, so please <a href="http://nightly.webkit.org/">get the latest nightly</a>.
- </div>
- <div id="mightneednewnightly" style="display: none;">
- You are already using a nightly build, which is very good! Unfortunately, we can't detect when you downloaded it, but
- if that was more then a few days ago, please <a href="http://nightly.webkit.org/">get the latest nightly</a>.
- </div>
- <div id="updateto10_4_4" style="display: none;">
- You are using Mac OS X 10.4.3 or lower, please before filing any bugs, do either of the following:
- <ul>
- <li>Upgrade to Mac OS X 10.4.4, or:</li>
- <li><a href="http://nightly.webkit.org">Download the latest nightly</a>.</li>
- </ul>
- </div>
- <div id="10_4_4" style="display: none;">
- You are using Mac OS X 10.4.4, go ahead and file your bug, or if you want to <a href="http://nightly.webkit.org">
- download the latest nightly</a> and see if your bug is already fixed.
- </div>
+ <div id="neednewnightly" style="display: none;">
+ You are already using a nightly build, which is very good! A large number of bugs has been fixed since you downloaded
+ this nightly build though, so please <a href="http://nightly.webkit.org/">get the latest nightly</a>.
+ </div>
+ <div id="mightneednewnightly" style="display: none;">
+ You are already using a nightly build, which is very good! Unfortunately, we can't detect when you downloaded it, but
+ if that was more then a few days ago, please <a href="http://nightly.webkit.org/">get the latest nightly</a>.
+ </div>
+ <div id="updateto10_4_4" style="display: none;">
+ You are using Mac OS X 10.4.3 or lower, please before filing any bugs, do either of the following:
+ <ul>
+ <li>Upgrade to Mac OS X 10.4.4, or:</li>
+ <li><a href="http://nightly.webkit.org">Download the latest nightly</a>.</li>
+ </ul>
+ </div>
+ <div id="10_4_4" style="display: none;">
+ You are using Mac OS X 10.4.4, go ahead and file your bug, or if you want to <a href="http://nightly.webkit.org">
+ download the latest nightly</a> and see if your bug is already fixed.
+ </div>
</div>
<script type="text/javascript">get_version();</script>
</li>
<li>
-<strong>Search Bugzilla</strong><br>
-Now that you have the latest WebKit version and still think you've found a WebKit bug,
-<a href="http://bugzilla.opendarwin.org/query.cgi?format=specific&product=WebKit">search through Bugzilla</a> first
-to see if anyone else has already filed it. This step is very important! If you find that someone has filed your bug
-already, please go to the next step anyway, but instead of filing a new bug, comment on the one you've found. If you can't
-find your bug in Bugzilla, go to the next step.
+ <strong>Search Bugzilla</strong><br>
+ Now that you have the latest WebKit version and still think you've found a WebKit bug,
+ <a href="http://bugzilla.opendarwin.org/query.cgi?format=specific&product=WebKit">search through Bugzilla</a> first
+ to see if anyone else has already filed it. This step is very important! If you find that someone has filed your bug
+ already, please go to the next step anyway, but instead of filing a new bug, comment on the one you've found. If you can't
+ find your bug in Bugzilla, go to the next step.
</li>
<li>
-<strong>Create a Bugzilla account</strong><br>
-You will need to <a href="http://bugzilla.opendarwin.org/createaccount.cgi">sign up for a Bugzilla account</a> to be able
-to report bugs (and to comment on them). Once you have an account you can report bugs on any product on
-<a href="http://www.opendarwin.org">OpenDarwin.org</a>. WebKit is one of the individual products listed in Bugzilla, and all
-of our bugs can be classified in various components under the WebKit product. If you have registered, proceed to the
-next step.
+ <strong>Create a Bugzilla account</strong><br>
+ You will need to <a href="http://bugzilla.opendarwin.org/createaccount.cgi">sign up for a Bugzilla account</a> to be able
+ to report bugs (and to comment on them). Once you have an account you can report bugs on any product on
+ <a href="http://www.opendarwin.org">OpenDarwin.org</a>. WebKit is one of the individual products listed in Bugzilla, and all
+ of our bugs can be classified in various components under the WebKit product. If you have registered, proceed to the
+ next step.
</li>
<li>
-<strong>File the bug!</strong><br>
-Now you are ready to <a href="http://webkit.org/new-bug">file a bug on the WebKit product</a>. The <a href="bugwriting.html">
-Writing a Good Bug Report</a> document (also linked in the sidebar) gives some tips about the most useful information to include
-in bug reports. The better your bug report, the higher the chance that your bug will be addressed (and possibly fixed)
-quickly!
+ <strong>File the bug!</strong><br>
+ Now you are ready to <a href="http://webkit.org/new-bug">file a bug on the WebKit product</a>. The <a href="bugwriting.html">
+ Writing a Good Bug Report</a> document (also linked in the sidebar) gives some tips about the most useful information to include
+ in bug reports. The better your bug report, the higher the chance that your bug will be addressed (and possibly fixed)
+ quickly!
</li>
<li>
-<strong>What happens next?</strong><br>
-Once your bug is filed, you will receive email when it is updated at each stage in the <a href="lifecycle.html">bug life cycle</a>.
-After the bug is considered fixed, you may be asked to download the <a href="http://nightly.webkit.org">latest nightly</a>
-and confirm that the fix works for you.
+ <strong>What happens next?</strong><br>
+ Once your bug is filed, you will receive email when it is updated at each stage in the <a href="lifecycle.html">bug life cycle</a>.
+ After the bug is considered fixed, you may be asked to download the <a href="http://nightly.webkit.org">latest nightly</a>
+ and confirm that the fix works for you.
</li>
</ol>
<p>
-<strong>Note:</strong> <br>
-To report bugs in Safari, or WebKit bugs that may contain confidential information, please use
-<a href="http://bugreporter.apple.com">http://bugreporter.apple.com/</a>.
+ <strong>Note:</strong> <br>
+ To report bugs in Safari, or WebKit bugs that may contain confidential information, please use
+ <a href="http://bugreporter.apple.com">http://bugreporter.apple.com/</a>.
</p>
</div>