blob: b2e6ebb89b2c9202ef323cd535190a131d14e952 [file] [log] [blame]
<?php require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/app.class.php"); require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/nav.class.php"); require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/menu.class.php"); $App = new App(); $Nav = new Nav(); $Menu = new Menu(); include($App->getProjectCommon());
$pageTitle = "Fixing a bug in SWT";
ob_start();
?>
<div id="midcolumn">
<h1>How to contribute a bug fix to SWT</h1>
<p></p>
<h2>Set up your Java environment:</h2>
<ol>
<li>Download and install a Java JRE (SWT only requires a 1.5.x JRE to
run but we suggest using Java 7 to run eclipse).<br>
</li>
<li><a href="http://www.eclipse.org/downloads/">Download and install the current Eclipse build.</a>
(Select the "Eclipse Classic" download.)</li>
<li><a href="/swt/git.php">Setup SWT from GIT.</a>
Make sure to load <code>org.eclipse.swt</code> plus any swt fragment you need
(for example, <code>org.eclipse.swt.gtk.linux.x86</code>),
<code>org.eclipse.swt.snippets</code>,
and <code>org.eclipse.swt.examples</code>.
<br>
</li>
<li>Click on any Snippet or example, and select Run As&gt;Java
Application. You can modify any of the existing snippets or make your own in order to try to reproduce the issue.<br>
</li>
<li> Once the issue is reproducible, inspect the SWT source code to see if you can locate/fix the issue.
(Debugging Tip: In gtk, you can switch between GTK2 and GTK3, by setting SWT_GTK3=0 or =1 in your launch configuration)</li>
<li> When you have a patch that is ready for review, you should submit the patch to gerrit for review. You have to configure your git repo to push to gerrit.
For more information and steps, please see <a href="https://wiki.eclipse.org/Gerrit">Gerrit wiki page</a>.
</ol>
<h2>Understand SWT:</h2>
The <a href="/swt/">eclipse.org/swt/</a> page contains many links
and resources that are useful for understanding SWT. Some of these are:
<ul>
<li><a href="/swt/widgets/">Snapshots of all of the SWT widgets</a></li>
<li><a href="/swt/snippets/">Little standalone snippets of SWT code</a></li>
<li><a href="/swt/examples.php">Larger examples of SWT code</a></li>
<li><a href="/swt/faq.php">A list of Frequently Asked Questions</a></li>
<li><a href="/swt/tools.php">Tools for implementing and testing SWT</a></li>
<li><a href="/swt/javadoc.php">Online Javadoc</a></li>
<li><a href="/swt/docs.php">A comprehensive list of SWT articles, tutorials, and other documentation</a></li>
</ul>
<h2>Understand open source:</h2>
<ul>
<li>Read up on Eclipse and <a href="http://wiki.eclipse.org/Development_Resources">
understand the Eclipse development process</a>.<br>
</li>
</ul>
<h3 style="margin-left: 40px;">Bugzilla<br>
</h3>
<ul>
<ul>
<li><a href="https://bugs.eclipse.org/bugs/page.cgi?id=bug-writing.html">Tips on filing new bugs</a>.</li>
<li><a href="/swt/bugs.php">Find or open SWT bugs and feature requests</a>.<br></li>
</ul>
</ul>
<h2>Find the Operating System doc:</h2>
<ul>
<li><a href="http://msdn.microsoft.com/en-ca/default.aspx">Windows documentation</a>.</li>
<li><a href="http://www.gtk.org/documentation.php">GTK documentation</a>.</li>
<li><a href="http://developer.apple.com/mac/library/navigation/index.html#section=Frameworks&topic=Cocoa%20Layer">Cocoa documentation</a>.</li>
<li><a href="http://www.opengroup.org/openmotif/docs/">Motif documentation</a>.</li>
</ul>
</div>
<?php
$html = ob_get_clean();
# Generate the web page
$App->generatePage($theme, $Menu, $Nav, $pageAuthor, $pageKeywords, $pageTitle, $html);
?>