| <?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>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); |
| ?> |