diff options
| author | Matthias Sohn | 2014-09-24 23:13:16 +0000 |
|---|---|---|
| committer | Matthias Sohn | 2014-09-24 23:13:16 +0000 |
| commit | df540a1e2c1c291037fc1ecca47ef89cc1dbbb84 (patch) | |
| tree | 07a0b993fff2deac90dae90d83966f3b13d8abf2 | |
| parent | fb73f77c6263408bc51b03989585b5e42b8b3354 (diff) | |
| download | egit-df540a1e2c1c291037fc1ecca47ef89cc1dbbb84.tar.gz egit-df540a1e2c1c291037fc1ecca47ef89cc1dbbb84.tar.xz egit-df540a1e2c1c291037fc1ecca47ef89cc1dbbb84.zip | |
Add EGit Contributor Guide to documentation
Change-Id: Ie00aa9217d94ad532be862e33e734b3dc26d7c82
Signed-off-by: Matthias Sohn <matthias.sohn@sap.com>
16 files changed, 1895 insertions, 1 deletions
diff --git a/org.eclipse.egit.doc/build-help.xml b/org.eclipse.egit.doc/build-help.xml index e97364e50d..8993657410 100644 --- a/org.eclipse.egit.doc/build-help.xml +++ b/org.eclipse.egit.doc/build-help.xml @@ -50,6 +50,7 @@ <path name="EGit/New_and_Noteworthy/3.5" title="EGit 3.5 New and Noteworthy" /> <path name="JGit/New_and_Noteworthy/3.5" title="JGit 3.5 New and Noteworthy" /> <path name="EGit/Git_For_Eclipse_Users" title="Git for Eclipse Users" /> + <path name="EGit/Contributor_Guide" title="EGit Contributor Guide" /> <stylesheet url="book.css" /> <pageAppendum> diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Bugs.html b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Bugs.html new file mode 100644 index 0000000000..7877a825e6 --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Bugs.html @@ -0,0 +1,271 @@ +<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <title>EGit Contributor Guide - Bugs</title> + <link type="text/css" rel="stylesheet" href="../../book.css"/> + </head> + <body> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <th style="width: 100%" align="center" colspan="3">Bugs</th> + </tr> + <tr> + <td style="width: 20%" align="left"> + <a href="Tests.html" title="Tests"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right"> + <a href="Website.html" title="Website"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Tests</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Website</td> + </tr> + </table><hr/> + <h1 id="Bugs">Bugs</h1> + <p>If you are looking for bugs/enhancements to start contributing, they have the keyword "helpwanted" or "bugday":</p> + <p> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?keywords=helpwanted%2C%20bugday%2C%20&keywords_type=anywords&list_id=7364111&resolution=---&query_format=advanced&product=EGit" target="egit_external">EGit bugs with helpwanted or bugday</a> + </p> + <p> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?keywords=helpwanted%2C%20bugday%2C%20&keywords_type=anywords&list_id=8951656&product=JGit&query_format=advanced&resolution=---" target="egit_external">JGit bugs with helpwanted or bugday</a> + </p> + <h2 id="Links">Links</h2> + <h3 id="Filing_Bugs">Filing Bugs</h3> + <p> + <a href="https://bugs.eclipse.org/bugs/enter_bug.cgi?product=EGit&rep_platform=All&op_sys=All" target="egit_external">File a bug for EGit</a> + </p> + <p> + <a href="https://bugs.eclipse.org/bugs/enter_bug.cgi?product=JGit&rep_platform=All&op_sys=All" target="egit_external">File a bug for JGit</a> + </p> + <h3 id="Bug_Reports_and_Links">Bug Reports and Links</h3> + <table border="1" cellpadding="3" cellspacing="0"> + <tr> + <th>Trends (bugs and enhancements)</th> + <th>EGit </th> + <th>JGit</th> + </tr> + <tr> + <td>Open by component (date range editable)</td> + <td> + <a href="https://bugs.eclipse.org/bugs/chart.cgi?category=EGit&datefrom=2011-01-01&dateto=&gt=1&label0=EGit%20Core%20Open&label1=EGit%20UI%20Open&labelgt=Grand%20Total&line0=1480&line1=1478&name=1478&subcategory=UI&action=wrap&width=1000&height=500" target="egit_external">Open</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/chart.cgi?category=JGit&datefrom=2011-01-01&dateto=&label0=JGit%20Open&line0=1592&name=1592&subcategory=JGit&action=wrap&width=1000&height=500" target="egit_external">Open</a> + </td> + </tr> + <tr> + <td>Open by status </td> + <td> + <a href="https://bugs.eclipse.org/bugs/reports.cgi?product=EGit&datasets=NEW&datasets=REOPENED&datasets=UNCONFIRMED&datasets=ASSIGNED" target="egit_external">Open</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/reports.cgi?product=JGit&datasets=NEW&datasets=REOPENED&datasets=UNCONFIRMED&datasets=ASSIGNED" target="egit_external">Open</a> + </td> + </tr> + <tr> + <td>Assigned </td> + <td> + <a href="https://bugs.eclipse.org/bugs/reports.cgi?product=EGit&datasets=ASSIGNED" target="egit_external">Assigned</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/reports.cgi?product=JGit&datasets=ASSIGNED" target="egit_external">Assigned</a> + </td> + </tr> + <tr> + <td>Open and closed by status </td> + <td> + <a href="https://bugs.eclipse.org/bugs/reports.cgi?product=EGit&datasets=NEW&datasets=REOPENED&datasets=UNCONFIRMED&datasets=VERIFIED&datasets=CLOSED&datasets=RESOLVED" target="egit_external">All</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/reports.cgi?product=JGit&datasets=NEW&datasets=REOPENED&datasets=UNCONFIRMED&datasets=VERIFIED&datasets=CLOSED&datasets=RESOLVED" target="egit_external">All</a> + </td> + </tr> + <tr> + <th>Lists</th> + <th>EGit</th> + <th>JGit</th> + </tr> + <tr> + <td><span style="color:red">Unresolved for passed target milestones</span> </td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?f1=OP&list_id=7727637&f0=OP&classification=Technology&f4=CP&query_format=advanced&j1=OR&f3=CP&f2=everconfirmed&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=EGit&target_milestone=0.10.0&target_milestone=0.10.0-M1&target_milestone=0.10.0-M2&target_milestone=0.10.0-M3&target_milestone=0.11&target_milestone=0.11-M1&target_milestone=0.11-M2&target_milestone=0.12&target_milestone=0.12-M1&target_milestone=0.12-M2&target_milestone=0.6.0-M1&target_milestone=0.6.0-M2&target_milestone=0.6.0-M3&target_milestone=0.7.0&target_milestone=0.8.0&target_milestone=0.9.0&target_milestone=0.9.0-M1&target_milestone=0.9.0-M2&target_milestone=0.9.0-M3&target_milestone=1.0.0&target_milestone=1.1&target_milestone=1.1-M1&target_milestone=1.1-M2&target_milestone=1.1-M3&target_milestone=1.2&target_milestone=1.2-M1&target_milestone=1.2-M2&target_milestone=1.3&target_milestone=1.3-M1&target_milestone=2.0&target_milestone=2.0-M1&target_milestone=2.0-M2&target_milestone=2.1&target_milestone=2.1-M1&target_milestone=2.2&target_milestone=2.2-M1&target_milestone=2.2-M2&target_milestone=2.3&target_milestone=2.4&target_milestone=3.0&target_milestone=3.0.1&target_milestone=3.0.2&target_milestone=3.1&target_milestone=3.2" target="egit_external">Open</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?f1=OP&list_id=7727591&f0=OP&classification=Technology&f4=CP&query_format=advanced&j1=OR&f3=CP&f2=everconfirmed&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=JGit&target_milestone=0.10.0&target_milestone=0.10.0-M1&target_milestone=0.10.0-M2&target_milestone=0.10.0-M3&target_milestone=0.11&target_milestone=0.11-M1&target_milestone=0.11-M2&target_milestone=0.12&target_milestone=0.12-M1&target_milestone=0.12-M2&target_milestone=0.6.0&target_milestone=0.7.0&target_milestone=0.8.0&target_milestone=0.9.0&target_milestone=0.9.0-M1&target_milestone=0.9.0-M2&target_milestone=0.9.0-M3&target_milestone=1.0.0&target_milestone=1.1&target_milestone=1.1-M1&target_milestone=1.1-M2&target_milestone=1.1-M3&target_milestone=1.2&target_milestone=1.2-M1&target_milestone=1.2-M2&target_milestone=1.3&target_milestone=1.3-M1&target_milestone=2.0&target_milestone=2.0-M1&target_milestone=2.0-M2&target_milestone=2.1&target_milestone=2.1-M1&target_milestone=2.2&target_milestone=2.2-M1&target_milestone=2.2-M2&target_milestone=2.3&target_milestone=2.4&target_milestone=3.0&target_milestone=3.0.2&target_milestone=3.1&target_milestone=3.2" target="egit_external">Open</a> + </td> + </tr> + <tr> + <td>Open bugs</td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?product=EGit&bug_status=NEW&bug_status=REOPENED&bug_status=UNCONFIRMED&bug_status=ASSIGNED&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&order=bug_severity" target="egit_external">Open</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?product=JGit&bug_status=NEW&bug_status=REOPENED&bug_status=UNCONFIRMED&bug_status=ASSIGNED&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&order=bug_severity" target="egit_external">Open</a> + </td> + </tr> + <tr> + <td>Open enhancements</td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?product=EGit&bug_status=NEW&bug_status=REOPENED&bug_status=UNCONFIRMED&bug_status=ASSIGNED&bug_severity=enhancement&order=bug_severity" target="egit_external">Open</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?product=JGit&bug_status=NEW&bug_status=REOPENED&bug_status=UNCONFIRMED&bug_status=ASSIGNED&bug_severity=enhancement&order=bug_severity" target="egit_external">Open</a> + </td> + </tr> + <tr> + <td>Bugs with votes</td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?f1=votes&list_id=2849777&columnlist=votes%2Cproduct%2Ccomponent%2Cassigned_to%2Cbug_status%2Cresolution%2Cshort_desc%2Cchangeddate&o1=greaterthan&resolution=---&v1=1&classification=Technology&query_format=advanced&product=EGit" target="egit_external">With Votes</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?f1=votes&list_id=2849777&columnlist=votes%2Cproduct%2Ccomponent%2Cassigned_to%2Cbug_status%2Cresolution%2Cshort_desc%2Cchangeddate&o1=greaterthan&resolution=---&v1=1&classification=Technology&query_format=advanced&product=JGit" target="egit_external">With Votes</a> + </td> + </tr> + <tr> + <td>Assigned bugs and enhancements </td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?product=EGit&bug_status=ASSIGNED&order=bug_severity" target="egit_external">Assigned</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?product=JGit&bug_status=ASSIGNED&order=bug_severity" target="egit_external">Assigned</a> + </td> + </tr> + <tr> + <th>Reports</th> + <th>EGit and JGit</th> + </tr> + <tr> + <td>Open EGit and JGit bugs</td> + <td> + <a href="https://bugs.eclipse.org/bugs/report.cgi?y_axis_field=bug_status&cumulate=1&format=bar&x_axis_field=product&query_format=report-graph&short_desc_type=allwordssubstr&product=EGit&product=JGit&longdesc_type=allwordssubstr&bug_file_loc_type=allwordssubstr&status_whiteboard_type=allwordssubstr&keywords_type=allwords&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=REOPENED&bug_status=ASSIGNED&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&emailtype1=substring&emailtype2=substring&bug_id_type=anyexact&chfieldto=Now&action=wrap&field0-0-0=noop&type0-0-0=noop" target="egit_external">Open</a> + </td> + </tr> + <tr> + <td>Assigned EGit and JGit bugs</td> + <td> + <a href="https://bugs.eclipse.org/bugs/report.cgi?y_axis_field=bug_status&cumulate=1&format=bar&x_axis_field=product&query_format=report-graph&short_desc_type=allwordssubstr&product=EGit&product=JGit&longdesc_type=allwordssubstr&bug_file_loc_type=allwordssubstr&status_whiteboard_type=allwordssubstr&keywords_type=allwords&bug_status=ASSIGNED&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&emailtype1=substring&emailtype2=substring&bug_id_type=anyexact&chfieldto=Now&action=wrap&field0-0-0=noop&type0-0-0=noop" target="egit_external">Assigned</a> + </td> + </tr> + <tr> + <td>New bugs opened</td> + <td> + <a href="https://bugs.eclipse.org/bugs/report.cgi?x_axis_field=bug_status&y_axis_field=product&z_axis_field=&query_format=report-table&short_desc_type=allwordssubstr&short_desc=&classification=Technology&product=EGit&product=JGit&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&emailtype1=substring&email1=&emailtype2=substring&email2=&bug_id_type=anyexact&bug_id=&votes=&chfieldfrom=-1d&chfieldto=Now&chfield=%5BBug+creation%5D&chfieldvalue=&format=table&action=wrap&field0-0-0=noop&type0-0-0=noop&value0-0-0=" target="egit_external">Last day</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/report.cgi?x_axis_field=bug_status&y_axis_field=product&z_axis_field=&query_format=report-table&short_desc_type=allwordssubstr&short_desc=&classification=Technology&product=EGit&product=JGit&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&emailtype1=substring&email1=&emailtype2=substring&email2=&bug_id_type=anyexact&bug_id=&votes=&chfieldfrom=-1w&chfieldto=Now&chfield=%5BBug+creation%5D&chfieldvalue=&format=table&action=wrap&field0-0-0=noop&type0-0-0=noop&value0-0-0=" target="egit_external">Last week</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/report.cgi?x_axis_field=bug_status&y_axis_field=product&z_axis_field=&query_format=report-table&short_desc_type=allwordssubstr&short_desc=&classification=Technology&product=EGit&product=JGit&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&emailtype1=substring&email1=&emailtype2=substring&email2=&bug_id_type=anyexact&bug_id=&votes=&chfieldfrom=-1m&chfieldto=Now&chfield=%5BBug+creation%5D&chfieldvalue=&format=table&action=wrap&field0-0-0=noop&type0-0-0=noop&value0-0-0=" target="egit_external">Last month</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/report.cgi?x_axis_field=bug_status&y_axis_field=product&z_axis_field=&query_format=report-table&short_desc_type=allwordssubstr&short_desc=&classification=Technology&product=EGit&product=JGit&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&emailtype1=substring&email1=&emailtype2=substring&email2=&bug_id_type=anyexact&bug_id=&votes=&chfieldfrom=-1y&chfieldto=Now&chfield=%5BBug+creation%5D&chfieldvalue=&format=table&action=wrap&field0-0-0=noop&type0-0-0=noop&value0-0-0=" target="egit_external">Last year</a> + </td> + </tr> + <tr> + <td>Bugs closed</td> + <td> + <a href="https://bugs.eclipse.org/bugs/report.cgi?x_axis_field=bug_status&y_axis_field=product&z_axis_field=&query_format=report-table&short_desc_type=allwordssubstr&short_desc=&classification=Technology&product=EGit&product=JGit&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&emailtype1=substring&email1=&emailtype2=substring&email2=&bug_id_type=anyexact&bug_id=&votes=&chfieldfrom=-1d&chfieldto=Now&chfield=bug_status&chfieldvalue=&format=table&action=wrap&field0-0-0=noop&type0-0-0=noop&value0-0-0=" target="egit_external">Last day</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/report.cgi?x_axis_field=bug_status&y_axis_field=product&z_axis_field=&query_format=report-table&short_desc_type=allwordssubstr&short_desc=&classification=Technology&product=EGit&product=JGit&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&emailtype1=substring&email1=&emailtype2=substring&email2=&bug_id_type=anyexact&bug_id=&votes=&chfieldfrom=-1w&chfieldto=Now&chfield=bug_status&chfieldvalue=&format=table&action=wrap&field0-0-0=noop&type0-0-0=noop&value0-0-0=" target="egit_external">Last week</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/report.cgi?x_axis_field=bug_status&y_axis_field=product&z_axis_field=&query_format=report-table&short_desc_type=allwordssubstr&short_desc=&classification=Technology&product=EGit&product=JGit&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&emailtype1=substring&email1=&emailtype2=substring&email2=&bug_id_type=anyexact&bug_id=&votes=&chfieldfrom=-1m&chfieldto=Now&chfield=bug_status&chfieldvalue=&format=table&action=wrap&field0-0-0=noop&type0-0-0=noop&value0-0-0=" target="egit_external">Last month</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/report.cgi?x_axis_field=bug_status&y_axis_field=product&z_axis_field=&query_format=report-table&short_desc_type=allwordssubstr&short_desc=&classification=Technology&product=EGit&product=JGit&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&emailtype1=substring&email1=&emailtype2=substring&email2=&bug_id_type=anyexact&bug_id=&votes=&chfieldfrom=-1y&chfieldto=Now&chfield=bug_status&chfieldvalue=&format=table&action=wrap&field0-0-0=noop&type0-0-0=noop&value0-0-0=" target="egit_external">Last year</a> + </td> + </tr> + </table> + <p> + <br/> + </p> + <p>To get notified of bugs, go to your e-mail preferences and add <product>.<component>-inbox@eclipse.org to your watch list. For example to get notified of EGit UI bugs, add + <i>egit.ui-inbox@eclipse.org</i>. + </p> + <h2 id="Keywords">Keywords</h2> + <p>To simplify bug management we started to tag EGit bugs with additional pseudo keywords (not normal Bugzilla keywords). The tags are prepended to the bug's summary field. Since we use these tags for internal bug management reporters of a bug should not add any pseudo keywords when filing the bug. The owner of the component bucket is responsible to add the keywords.</p> + <p>Keywords are used to group bugs without assigning them to a developer. So with the introduction of the keywords it is easy to search for all bugs belonging to a specific sub component. For example to get an overview of all open refactoring issues search for new, assigned or reopened bugs containing the word + <a href="refactoring">refactoring</a> in the summary field. + </p> + <p>Be aware that not all bugs are tagged with keywords, only bugs that belong to a certain sub group may have a tag attached. The following lists some of the currently used tags.</p> + <table border="1" cellpadding="3" cellspacing="0"> + <tr> + <th>Tag</th> + <th>Description</th> + <th>Link</th> + </tr> + <tr> + <td> + <a href="sync">sync</a> + </td> + <td>everything related to Synchronize / Synchronize View</td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?short_desc=%5Bsync%5D;query_format=advanced;bug_status=UNCONFIRMED;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;short_desc_type=allwordssubstr;product=EGit" target="egit_external">View bugs</a> + </td> + </tr> + <tr> + <td> + <a href="repoView">repoView</a> + </td> + <td>everything related to the Git Repository View</td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?short_desc=%5BrepoView%5D;query_format=advanced;bug_status=UNCONFIRMED;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;short_desc_type=allwordssubstr;product=EGit" target="egit_external">View bugs</a> + </td> + </tr> + <tr> + <td> + <a href="releng">releng</a> + </td> + <td>everything related to release engineering and build</td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?short_desc=%5Breleng%5D;query_format=advanced;bug_status=UNCONFIRMED;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;short_desc_type=allwordssubstr;product=EGit" target="egit_external">View bugs</a> + </td> + </tr> + <tr> + <td> + <a href="historyView">historyView</a> + </td> + <td>everything related to the Git History View</td> + <td> + <a href="https://bugs.eclipse.org/bugs/buglist.cgi?short_desc=%5BhistoryView%5D;query_format=advanced;bug_status=UNCONFIRMED;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;short_desc_type=allwordssubstr;product=EGit" target="egit_external">View bugs</a> + </td> + </tr> + </table> + <p> + <br/> + </p><hr/> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <td style="width: 20%" align="left"> + <a href="Tests.html" title="Tests"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"> + <a href="Contributor-Guide.html" title="EGit Contributor Guide"> + <img alt="EGit Contributor Guide" border="0" src="../../images/home.gif"/> + </a> + </td> + <td style="width: 20%" align="right"> + <a href="Website.html" title="Website"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Tests</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Website</td> + </tr> + </table> + </body> +</html>
\ No newline at end of file diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Builds.html b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Builds.html new file mode 100644 index 0000000000..c63a36cbbb --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Builds.html @@ -0,0 +1,219 @@ +<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <title>EGit Contributor Guide - Builds</title> + <link type="text/css" rel="stylesheet" href="../../book.css"/> + </head> + <body> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <th style="width: 100%" align="center" colspan="3">Builds</th> + </tr> + <tr> + <td style="width: 20%" align="left"> + <a href="Development-IDE-Configuration.html" title="Development IDE Configuration"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right"> + <a href="Documentation.html" title="Documentation"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Development IDE Configuration</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Documentation</td> + </tr> + </table><hr/> + <h1 id="Builds">Builds</h1> + <p>The central EGit and JGit builds run on the + <a href="https://hudson.eclipse.org/egit/" target="egit_external">JGit/EGit Hudson instance</a> + </p> + <p>Prerequisites for the Maven build are</p> + <ul> + <li> + <a href="http://maven.apache.org/download.html" target="egit_external">at least Maven 3.0.0</a> (but currently not Maven 3.1.0) + </li> + <li>see + <a href="http://maven.apache.org/settings.html" target="egit_external">settings.xml reference</a> on how to do basic Maven configuration + </li> + <li>if you want to learn how Maven works start reading + <a href="http://maven.apache.org/guides/getting-started/index.html" target="egit_external">the Maven Getting Started Guide</a> + </li> + </ul> + <p>Hudson</p> + <ul> + <li> + <a href="https://hudson.eclipse.org/egit/master" target="egit_external">development build jobs</a> + </li> + <li> + <a href="https://hudson.eclipse.org/egit/stable" target="egit_external">maintenance and release build jobs</a> + </li> + </ul> + <h2 id="JGit_2">JGit</h2> + <ul> + <li>JGit can be built using Maven 2 or 3.</li> + <li>use Java 7 to run the JGit Maven build (required since bundle + <i>org.eclipse.jgit.java7</i> needs Java 7) + </li> + <li>JGit packaging projects (Eclipse feature and update site) are built using Maven 3 and Tycho.</li> + </ul> + <h2 id="EGit_2">EGit</h2> + <ul> + <li>EGit is built using Maven 3 and Tycho.</li> + </ul> + <h2 id="Mailing_Lists">Mailing Lists</h2> + <p>If you're interested in following builds, please check out the following mailing lists:</p> + <ul> + <li> + <a href="https://dev.eclipse.org/mailman/listinfo/jgit-build" target="egit_external">Subscribe to jgit-build@eclipse.org</a> + </li> + <li> + <a href="https://dev.eclipse.org/mailman/listinfo/egit-build" target="egit_external">Subscribe to egit-build@eclipse.org</a> + </li> + </ul> + <h2 id="Maven_Build_Sequence">Maven Build Sequence</h2> + <ul> + <li>Due to a + <a href="http://wiki.eclipse.org/Tycho/How_Tos/Dependency_on_pom-first_artifacts" target="egit_external">current limitation of Tycho</a> it is not possible to mix pom-first and manifest-first builds in the same reactor build hence the pom-first JGit build has to run separately before the build for the manifest-first JGit packaging project. + </li> + <li>The 3 builds must share the same local Maven repository otherwise dependencies between these builds cannot be resolved.</li> + <li>To run the build behind a firewall follow + <a href="http://maven.apache.org/guides/mini/guide-proxies.html" target="egit_external">http://maven.apache.org/guides/mini/guide-proxies.html</a> + </li> + </ul> + <p>Complete build sequence for a clean build (assuming $M2_HOME/bin is on the path and local Maven repository at ~/.m2/repository):</p> + <pre style="width: 55em;">[~/src/jgit] $ mvn clean install +[INFO] Scanning for projects... +... + +[~/src/jgit] $ mvn -f org.eclipse.jgit.packaging/pom.xml clean install +[INFO] Scanning for projects... +... + +[~/src/jgit] $ cd ../egit + +[~/src/egit] $ mvn clean install +[INFO] Scanning for projects... +... +</pre> + <p>The EGit build uses the JGit p2 repository to resolve jgit dependencies. For local builds the build assumes + that egit and jgit source trees are located under a common parent folder. If this is not the case the path + to the jgit p2 repository has to be injected via system property:</p> + <pre><a href="~/src/egit">~/src/egit</a> $ mvn clean install -Djgit-site=file:/path/to/org.eclipse.jgit.updatesite/target/site +</pre> + <p>The hudson build on build.eclipse.org uses (for SNAPSHOT builds):</p> + <pre><a href="~/src/egit">~/src/egit</a> $ mvn clean install -Djgit-site=<a href="https://repo.eclipse.org/content/unzip/snapshots.unzip/" target="egit_external">https://repo.eclipse.org/content/unzip/snapshots.unzip/</a> + org/eclipse/jgit/org.eclipse.jgit.repository/${JGIT_VERSION}/org.eclipse.jgit.repository-${JGIT_VERSION}.zip-unzip/ +</pre> + <p>If you wan to build EGit for the specific Juno platform, consider using the <code>platform-juno</code> maven profile:</p> + <pre><a href="~/src/egit">~/src/egit</a> $ mvn -P platform-juno clean install +</pre> + <p>For EGit version 3.0, <code>platform-juno</code> (Eclipse 4.2) and <code>platform-kepler</code> (Eclipse 4.3) are available. In addition <code>platform-kepler-staging</code> refers to the Kepler staging repository.</p> + <p>Upon a successful build, a p2 update site should be generated inside + <i>egit/org.eclipse.egit.repository/target/repository</i>. If not, make sure the target platform has been downloaded from within Eclipse (Windows>Preferences>Plug-in Development>Target Platform). The default target platform defined in the maven build is currently Eclipse 4.3. + </p> + <h2 id="FindBugs_and_PMD">FindBugs and PMD</h2> + <p>As part of the build, JGit and EGit run FindBugs and PMD to find issues.</p> + <ul> + <li> + <a href="https://hudson.eclipse.org/egit/job/jgit/findbugs" target="egit_external">JGit FindBugs Results</a> + </li> + <li> + <a href="https://hudson.eclipse.org/egit/job/jgit/dry" target="egit_external">JGit DRY (PMD) Results</a> + </li> + <li> + <a href="https://hudson.eclipse.org/egit/job/egit/findbugs" target="egit_external">EGit FindBugs Results</a> + </li> + <li> + <a href="https://hudson.eclipse.org/egit/job/egit/dry" target="egit_external">EGit DRY (PMD) Results</a> + </li> + </ul> + <h2 id="Checking_for_JGit_API_Changes_using_API_Baseline">Checking for JGit API Changes using API Baseline</h2> + <p>The JGit projects have API tooling enabled. In order to use PDE API tools to get assistance with maintaining API changes and additions you need to set an API baseline:</p> + <ul> + <li>download the p2 repository for the latest EGit release (which includes the JGit artifacts) to a local folder, e.g. <code>~/egit-releases/updates-3.0</code>, find the p2 repository URLs + <a href="http://wiki.eclipse.org/EGit/FAQ#Where_can_I_find_older_releases_of_EGit.3F" target="egit_external">here</a> and see + <a href="http://wiki.eclipse.org/Equinox_p2_Repository_Mirroring#Mirroring_Artifacts" target="egit_external">mirroring artifacts</a> for a way to download the repository + </li> + <li>in Eclipse click "Preferences > Plug-In Development > API Baselines", click "Add Baseline..." and define a new baseline (e.g. egit-3.0) and point it to the local copy of the corresponding EGit p2 repository.</li> + <li>the API tools will then raise warning/errors for all detected problems and provide quick fixes helping to resolve these problems</li> + <li>see the + <a href="http://wiki.eclipse.org/PDE/API_Tools/User_Guide" target="egit_external">PDE API Tools User Guide</a> for more details. + </li> + </ul> + <h2 id="Automated_Signing_and_Publishing">Automated Signing and Publishing</h2> + <p>EGit and JGit builds running on the + <a href="https://hudson.eclipse.org/egit/" target="egit_external">JGit/EGit Hudson</a> are automatically signed + (using the + <a href="http://wiki.eclipse.org/Common_Build_Infrastructure#Signing_tool" title="Common_Build_Infrastructure#Signing_tool" target="egit_external">CBI eclipse-jarsigner-plugin</a>) and published to the folder + </p> + <pre> +master branch: /home/data/httpd/download.eclipse.org/egit/updates-nightly +latest stable branch: /home/data/httpd/download.eclipse.org/egit/updates-stable-nightly +</pre> + <ul> + <li>To enable signing the maven profile <code>eclipse-sign</code> must be enabled via the option <code>-P eclipse-sign</code> in the respective build jobs running at + <a href="https://hudson.eclipse.org/egit/" target="egit_external">https://hudson.eclipse.org/egit/</a> + </li> + <li>To enable publishing to + <i>download.eclipse.org</i> the maven profile <code>publish</code> must be enabled via the option <code>-P publish</code> in the egit build job. + </li> + </ul> + <h4 id="Signing_.28old_method.2C_replaced_by_automated_procedure.29">Signing (old method, replaced by automated procedure)</h4> + <p>To sign the EGit build, you need to have ssh access to build.eclipse.org and the ability to run + <b>/usr/bin/sign</b> + </p> + <p>At the moment, Chris Aniszczyk (caniszczyk) and Matthias Sohn (msohn) have signing privileges.</p> + <p>The first step is to ensure you're in a place you can sign on build.eclipse.org</p> + <pre>cd /home/data/httpd/download-staging.priv/commonBuild +</pre> + <p>Next you run the signing command (Usage: /usr/bin/sign <file> <mail|nomail> + <a href="outputDir">outputDir</a>) on a zip of the EGit repo... + </p> + <pre>sign egit-p2-repo.zip my@email.com /home/data/users/caniszczyk/egit-0.8 +</pre> + <p>After that, you can publish the zip that is generated with the signing information.</p> + <h2 id="Contribution_to_Release_Train">Contribution to Release Train</h2> + <p>The release train contribution for JGit and EGit is maintained in the git repository </p> + <pre>ssh://git.eclipse.org/gitroot/simrel/org.eclipse.simrel.build.git +</pre> + <p>in the file</p> + <pre>egit.b3aggrcon +</pre> + <p>The release train build is coordinated on the + <a href="https://dev.eclipse.org/mailman/listinfo/cross-project-issues-dev" target="egit_external">cross-project-issues-dev mailing list</a> + </p> + <p> + <br/> + </p><hr/> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <td style="width: 20%" align="left"> + <a href="Development-IDE-Configuration.html" title="Development IDE Configuration"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"> + <a href="Contributor-Guide.html" title="EGit Contributor Guide"> + <img alt="EGit Contributor Guide" border="0" src="../../images/home.gif"/> + </a> + </td> + <td style="width: 20%" align="right"> + <a href="Documentation.html" title="Documentation"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Development IDE Configuration</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Documentation</td> + </tr> + </table> + </body> +</html>
\ No newline at end of file diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Contributing-Patches.html b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Contributing-Patches.html new file mode 100644 index 0000000000..3760da57e5 --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Contributing-Patches.html @@ -0,0 +1,414 @@ +<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <title>EGit Contributor Guide - Contributing Patches</title> + <link type="text/css" rel="stylesheet" href="../../book.css"/> + </head> + <body> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <th style="width: 100%" align="center" colspan="3">Contributing Patches</th> + </tr> + <tr> + <td style="width: 20%" align="left"> + <a href="Website.html" title="Website"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right"> + <a href="Gerrit-Code-Review-Cheatsheet.html" title="Gerrit Code Review Cheatsheet"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Website</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Gerrit Code Review Cheatsheet</td> + </tr> + </table><hr/> + <h1 id="Contributing_Patches">Contributing Patches</h1> + <h2 id="Using_Gerrit_at_Eclipse">Using Gerrit at Eclipse</h2> + <p>EGit and JGit projects are using + <a href="http://code.google.com/p/gerrit/" target="egit_external">Gerrit Code Review</a> for Git based patch submission and review. + </p> + <p>Parts of this chapter are also available in the + <a href="http://wiki.eclipse.org/Gerrit#Doing_Code_Reviews_with_Gerrit" target="egit_external">Eclipse Gerrit wiki</a>. + </p> + <h3 id="User_Account">User Account</h3> + <ul> + <li>In order to contribute you need an + <a href="https://dev.eclipse.org/site_login/createaccount.php" target="egit_external">Eclipse user account</a> on eclipse.org, on creation of a new account you must agree to the Contributor Agreement. + </li> + </ul> + <h3 id="Legal_Paperwork">Legal Paperwork</h3> + <p>Before your first contribution can be accepted, you need to electronically sign the + <a href="http://www.eclipse.org/legal/CLA.php" target="egit_external">Eclipse Foundation Contributor License Agreement</a> (CLA). You only have to do this once, and it covers all Eclipse projects. + The new process was discussed in + <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=381105" target="egit_external">bug 381105</a> and + <a href="http://dev.eclipse.org/mhonarc/lists/eclipse.org-committers/msg00933.html" target="egit_external">introduced on June 27, 2013</a>. + </p> + <p>Minimally, all Git commits you contribute must have the following:</p> + <ul> + <li>A single line summary in the comment field, followed by a more detailed descriptive paragraph;</li> + <li>Your credentials (email address) captured in the "Author" field; and</li> + <li>A "Signed-off-by" entry with matching credentials in the comment.</li> + <li>The "Signed-off-by" entry is required. By including this, you confirm that you are in compliance with the + <a href="http://www.eclipse.org/legal/CoO.php" target="egit_external">Certificate of Origin</a>. + </li> + </ul> + <p>In addition ensure</p> + <ul> + <li>that the contributed code is licensed under the project license (EPL for EGit and EDL for JGit). This is done by putting a + <a href="http://www.eclipse.org/legal/copyrightandlicensenotice.php" target="egit_external">copyright and license header</a> into every new java file. See other existing project source files for the correct content. + </li> + </ul> + <p>With a valid CLA on file, the signed-off commit and the copyright and license header in place, we will be able to accept small patches (<1000 LoC) immediately. For larger patches, we will also have to create a contribution questionnaire for review by the Eclipse IP team, but this usually doesn't require additional actions from you.</p> + <p>To verify whether a contribution + <a href="https://dev.eclipse.org/mhonarc/lists/eclipse.org-committers/msg00973.html" target="egit_external">requires a CQ</a>, use one of the following git commands to check: + </p> + <ul> + <li>If it's committed: git log --shortstat</li> + <li>If not committed: git diff --stat</li> + </ul> + <p>These commands tell you the number of insertions(+), and deletions(-). If the total number of lines inserted (e.g. added) in a contribution is greater than 1000 (yes, this includes comments) then a CQ is required.</p> + <p>Find more details about how to contribute in + <a href="http://wiki.eclipse.org/Development_Resources/Contributing_via_Git" target="egit_external">Contributing via Git (for contributors)</a> and + <a href="http://wiki.eclipse.org/Development_Resources/Handling_Git_Contributions" target="egit_external">Handling Git Contributions (for committers)</a>. + </p> + <h3 id="Logon">Logon</h3> + <h4 id="Gerrit_Web_UI">Gerrit Web UI</h4> + <p>Logon to the Gerrit Web UI at <code> + <a href="https://git.eclipse.org/r/" target="egit_external">https://git.eclipse.org/r/</a></code> using the email address you registered with your Eclipse (and Bugzilla) account and your Eclipse password. + </p> + <h4 id="Git_over_SSH">Git over SSH</h4> + <p>When accessing Gerrit over SSH from git or EGit use the username displayed + <a href="https://git.eclipse.org/r/#/settings/" target="egit_external">here</a> and upload your public SSH key to Gerrit + <a href="https://git.eclipse.org/r/#/settings/ssh-keys" target="egit_external">here</a>. + </p> + <p>Gerrit SSH URl: <code>ssh://username@git.eclipse.org:29418/egit/egit.git</code></p> + <h4 id="Git_over_HTTPS">Git over HTTPS</h4> + <p>When accessing Gerrit over HTTPS from git or EGit use username and HTTP password displayed + <a href="https://git.eclipse.org/r/#/settings/http-password" target="egit_external">here</a> + </p> + <p>Gerrit HTTPS URl: <code> + <a href="https://git.eclipse.org/r/p/egit/egit.git" target="egit_external">https://git.eclipse.org/r/p/egit/egit.git</a></code> + </p> + <h3 id="SSH_Keys">SSH Keys</h3> + <ul> + <li>Add one or more public SSH keys to + <a href="https://git.eclipse.org/r/#/settings/ssh-keys" target="egit_external">Gerrit here</a>. + </li> + <li>If you are + <b>absolutely certain</b> you do not have keys already, you must create a public and private pair of SSH keys. It is strongly recommended that you + <a href="http://help.github.com/working-with-key-passphrases" target="egit_external">use a passphrase.</a> + </li> + <li> + <b>Generating SSH key pair on command line</b> + </li> + </ul> + <pre><pre style="width: 60em;">ssh-keygen -t rsa -C "your_email@youremail.com"</pre> +</pre> + <ul> + <li>Execute SSH once to accept the host key (or copy it from the registration web page)</li> + </ul> + <pre style="width: 60em;">ssh -p 29418 username@git.eclipse.org +</pre> + <p> </p> + <ul> + <li> + <a href="http://wiki.eclipse.org/EGit/User_Guide#Eclipse_SSH_Configuration" target="egit_external">Generating SSH key pair in Eclipse</a> + </li> + </ul> + <h3 id="Doing_Code_Reviews_with_Gerrit">Doing Code Reviews with Gerrit</h3> + <ul> + <li>Visit the + <a href="https://git.eclipse.org/r/" target="egit_external">Eclipse Gerrit Code Review instance</a> to start reviewing, + </li> + <li> + <a href="https://git.eclipse.org/r/#/settings/projects" target="egit_external">Register to watch projects</a> if you want to be notified by email on new or updated changes pushed for review + </li> + <li>Adjust your + <a href="https://git.eclipse.org/r/#/settings/preferences" target="egit_external">Gerrit preferences</a> to customize it to your needs + </li> + <li>See the + <a href="https://git.eclipse.org/r/Documentation/index.html#_user_guide" target="egit_external">Gerrit user guide</a> for more information about using Gerrit. + </li> + <li>The + <a href="http://wiki.eclipse.org/EGit/User_Guide#EGit_Tutorial_.28EclipseCon_Europe_Nov_2011.29" target="egit_external">EGit tutorial</a> walks you through the basic steps of working with Gerrit and EGit. + </li> + <li>Use + <a href="https://git.eclipse.org/r/Documentation/user-search.html" target="egit_external">Gerrit queries</a> to filter the review list for changes you are interested in: + <ul> + <li> + <a href="https://git.eclipse.org/r/#/q/status:open+project:egit/egit,n,z" target="egit_external">EGit changes pending in review</a> + </li> + <li> + <a href="https://git.eclipse.org/r/#/q/status:open+project:jgit/jgit,n,z" target="egit_external">JGit changes pending in review</a> + </li> + </ul> + </li> + </ul> + <h3 id="Using_Gerrit_with_git_command_line:">Using Gerrit with git command line:</h3> + <ul> + <li>Upload your patch from Git to the target project:</li> + </ul> + <p> + <b>JGit</b> + </p> + <pre style="width: 60em;">git push ssh://username@git.eclipse.org:29418/jgit/jgit.git HEAD:refs/for/master +</pre> + <p> + + <b>EGit</b> + </p> + <pre style="width: 60em;">git push ssh://username@git.eclipse.org:29418/egit/egit.git HEAD:refs/for/master +</pre> + <p> </p> + <ul> + <li>Visit the + <a href="https://git.eclipse.org/r/" target="egit_external">Eclipse Gerrit Code Review server</a> to start reviewing + </li> + </ul> + <h4 id="Adding_a_dedicated_remote">Adding a dedicated remote</h4> + <p>Since git can have multiple remotes, you can define one to be used to refer to Gerrit to save typing. Inside a previously checked-out repository you can run: </p> + <pre>cd path/to/jgit +git config remote.review.url ssh://username@git.eclipse.org:29418/jgit/jgit.git +git config remote.review.push HEAD:refs/for/master + +cd path/to/egit +git config remote.review.url ssh://username@git.eclipse.org:29418/egit/egit.git +git config remote.review.push HEAD:refs/for/master +</pre> + <p> + You can now submit review requests from either repository using: </p> + <pre>git push review +</pre> + <h3 id="Using_Gerrit_with_EGit:">Using Gerrit with EGit:</h3> + <p>Eclipse will look for your private key in the SSH2 Home location specified in the General>Network Connections>SSH2 Preference Page. If your <code>id_rsa</code> private key makes use of the AES-128-CBC algorithm (view the file as text to confirm), Eclipse will need at least <code>com.jcraft.jsch 0.1.44</code> to make use of it.</p> + <ul> + <li> + <a href="../../EGit/User_Guide/Tasks.html#Cloning_Remote_Repositories" title="EGit/User_Guide#Cloning_Remote_Repositories">Clone the JGit and EGit repositories</a> and select + <b>Gerrit Configuration...</b> in the context menu of the remote "origin" in the Git Repositories view to + <a href="http://wiki.eclipse.org/EGit/User_Guide#Gerrit_Configuration" target="egit_external">configure pushing to the code review queue</a>. + </li> + <li>Alternative approach: Add a new review remote in the Git Repositories view and select + <b>Gerrit Configuration...</b> in the context menu of the remote + <ul> + <li>From the appropriate Remotes node, create a New Remote and choose to Configure for Push. A unique name should be chosen, + <i>review</i> is suggested. + </li> + <li>Changes committed to your local clone can now be pushed to Gerrit using the + <i>review</i> Remote. You will be prompted for your private key's passphrase if Eclipse is looking for it in the right place. + </li> + </ul> + </li> + <li>Instead of using the + <b>Gerrit Configuration...</b> wizard you can do the configuration steps manually: + <ul> + <li>Change the main URI or Add a Push URI (your Gerrit user name must be used here) + <ul> + <li><code>ssh://username@git.eclipse.org:29418/(project).git</code> </li> + </ul> + </li> + <li>In the Ref mapping section, add a RefSpec specification of <code>HEAD:refs/for/master</code></li> + </ul> + </li> + </ul> + <ul> + <li>Visit our + <a href="https://git.eclipse.org/r/" target="egit_external">Gerrit Code Review instance</a> to start reviewing + </li> + </ul> + <h3 id="Using_the_Mylyn_Gerrit_Connector">Using the Mylyn Gerrit Connector</h3> + <p>The Mylyn Gerrit Connector can be installed from the Mylyn p2 repository, e.g. for juno from + <a href="http://download.eclipse.org/mylyn/releases/juno" target="egit_external">http://download.eclipse.org/mylyn/releases/juno</a>. + </p> + <p>It contains several useful features:</p> + <ul> + <li>Cloning from Gerrit and automatic configuration + <ul> + <li>The wizards "Import Projects from Git" and "Clone Git Repository" will offer the possibility to browse the list of repositories on Gerrit servers and to clone selected repositories. After cloning the Gerrit configuration will be done automatically.</li> + </ul> + </li> + <li>Importing Gerrit changes as Mylyn tasks</li> + <li>Fetching patch sets directly from the task editor</li> + <li>Reviewing changes in the task editor</li> + <li>Submitting changes from the task editor</li> + </ul> + <h2 id="Granularity_of_Changes">Granularity of Changes</h2> + <ul> + <li>Make small commits, as small as reasonable. This makes them easy to review.</li> + <li>Each commit should have a commit message that explains very clearly what the commit sets out to achieve (unless this is abundantly clear from the code itself, which is basically only the case for trivial patches). Also, when you fix a bug then report which bug you fix. When there are deeper reasons for doing things the way the commit does, then explain these as well. This all is for the reviewers and yourself: the context of the commit is completely clear.</li> + <li>Do not mix concerns in commits: have a commit do a single thing. This makes them reviewable 'in isolation'. The purpose of the commit is clear and can be understood easily by the reviewers and yourself.</li> + <li>Do not break the build and tests for + <b>any commit</b>: this is very important for bug hunting. + </li> + <li>Split your work into multiple smaller pieces of work (when possible) and implement each of these pieces in a series of commits.</li> + <li>A series of commits should work towards a 'feature' in a clear way and only 'enable' the feature in the last commit of the series.</li> + <li>In a series of commits first lay the groundwork and then build on that towards the feature.</li> + </ul> + <h3 id="Branches">Branches</h3> + <p>When working with Gerrit, you can create local branches as you wish. When you are ready to push your changes, only the commits from your branch are pushed and are converted to reviews on Gerrit. The branch name itself is not visible on Gerrit.</p> + <p>Do not mix unrelated changes in branches: When you encounter a bug while working on something then create a new branch to fix the bug. Make sure you base it on the state of the remote branch that you want your fix to go to, e.g. + <i>origin/master</i>. If you have other changes that depend on the bug being fixed then rebase your work on that new branch. + </p> + <p>Merge/Rebase: If you want your branch to include new commits from the remote repository, rebase your local branch. The reason for this is that in Gerrit, changes are reviewed one commit at a time, and modified until all review feedback has been addressed. This is different from a pull request workflow, where the combined changes are reviewed and feedback is addressed with additional commits.</p> + <h2 id="Coding_standards">Coding standards</h2> + <p>Eclipse has standards for how to write code.</p> + <p> + <a href="http://wiki.eclipse.org/Coding_Conventions" title="Coding_Conventions" target="egit_external">Coding conventions</a> + </p> + <p> + <a href="http://wiki.eclipse.org/User_Interface_Guidelines" title="User_Interface_Guidelines" target="egit_external">Use interface guidelines</a> + </p> + <p>These documents have links to other document. Browse through them without expecting to learn everything, just so you know roughly what areas and types of details they covert. When you are + not sure about how to write a piece of code or design the user interface, these are the two + first places to look at.</p> + <p>In addition there is all the worlds collective knowledge on how to write programs that shine. + When there is a conflict, the Eclipse guide lines and conventions take precedence.</p> + <p>Breaking the rules is ok if there is a very good reason and you can tell us what that reason + is.</p> + <p>In addition to these general rules, we regard performance high. If the EGit plugin is slow + in any way, that is a bug and should be reported and fixed. Java isn't slow, but there is a + lot of slow Java code.</p> + <h3 id="Braces_for_one-line_statements">Braces for one-line statements</h3> + <p>Both in JGit and EGit, the preferred coding style is to leave off braces around statements with one line, e.g.:</p> + <pre>if (condition) + doSomething(); +</pre> + <p>Some exceptions to this rule:</p> + <ul> + <li>Don't leave off braces when the inner element is a try block</li> + <li>Don't leave off braces when the inner element is a long or deeply-nested if/else block</li> + </ul> + <h3 id="Removing_trailing_whitespace">Removing trailing whitespace</h3> + <p>In JGit and EGit we have enabled the save action "Remove trailing white spaces on all lines" for Java sources. This works except for empty comment lines, see + <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=414421" target="egit_external">bug 414421</a>. + </p> + <p>As a workaround, use the following sequence of commands in the Java editor to trick the save action:</p> + <ul> + <li>remove the offending trailing whitespace</li> + <li>the save action re-adds the trailing whitespace</li> + <li>CTRL-Z (CMD-Z on Mac) removes the re-added whitespace without triggering the save action again</li> + </ul> + <p>Another workaround is to use + <a href="http://stackoverflow.com/questions/10413922/convert-spaces-to-tabs-in-lines-i-changed-in-a-commit?answertab=active#tab-top" target="egit_external">this little script</a> from the command line to edit away trailing whitespace from changed lines. + </p> + <h2 id="Commit_message_guidelines">Commit message guidelines</h2> + <ul> + <li>The commit message header should fit on one line and should start with an uppercase letter. A blank line separates it from the body of the message.</li> + <li>The first line should be a clear and concise description about the change and should not end with a dot. </li> + <li>Enter a newline before providing a more detailed description about the change.</li> + <li>Format the commit message to have newline characters after every 60-70 characters. </li> + <li>Find more reasoning about commit message formatting in + <a href="http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html" target="egit_external">"A Note About Git Commit Messages"</a> + </li> + <li> + <i>Commit message footers</i> (everything following the last blank line in the commit message) in + <i>Key: value</i> format are used for additional commit meta data. Some tools especially + <i>Gerrit</i> parse this meta data to provide additional functionality. + <ul> + <li>If there is an associated bug number in Bugzilla about it, it should come as a + <i>Bug:</i> footer right before Gerrit's Change-Id entry (if available) or towards the end. + </li> + <li>If a + <i>Contribution Questionnaire</i> has been issued to initiate and track the review of contributed changes by the Eclipse Foundation's IP team the IPZilla bug number should be added as + <i>CQ:</i> footer in the format shown below + </li> + <li>A + <i>Gerrit Change-Id</i> footer is required for all changes pushed to Gerrit (to enable pushing new patchsets for the same change), it should be added in the format shown below. Use the + <a href="Install_the_commit-msg_hook_in_your_repository" title="EGit/Contributor_Guide#Install_the_commit-msg_hook_in_your_repository">Gerrit commit message hook or EGit</a> to add the + <i>Change-Id</i>. + </li> + <li>A "Signed-off-by" can be added at the end of the commit message (see example below). Note: at the moment this is not required but may be used to list all who modified (amended, rebased, cherry-picked) this change.</li> + </ul> + </li> + </ul> + <pre>Fix the commit dialog to respect the workbench's selection + +Originally, the commit dialog would automatically check off all +files in the dialog. This behaviour contradicts a user's expectation +because their selection in the workbench is completely ignored. The +code has been corrected to only preselect what the user has actually +selected. + +Bug: 12345 +CQ: 6031 +Change-Id: I71ac4844ab9d2f848352eba9252090c586b4146a +Signed-off-by: Your Name <your.email@example.org> +</pre> + <h2 id="Copyright">Copyright</h2> + <p>When contributing patches, you have to update the copyright section at the beginning of the file if there is one. Please follow the style that is already present in the file. Some examples follow.</p> + <p>When there is only one copyright present (from a person or a company), like this:</p> + <pre>Copyright (C) 2010, 2011 Some Name <some@example.org> +</pre> + <p>Change it like this (notice the updated year):</p> + <pre>Copyright (C) 2010, YEAR Some Name <some@example.org> and others. +</pre> + <p>If there is a section <tt>Contributors:</tt> below the legal text and your change is more than a few lines, you can add your name there and optionally describe the change and link to a bug number. You can also start such a section if you contributed a significant change.</p> + <p>When there are multiple copyright entries there, add yours as a separate line. So, given this:</p> + <pre>Copyright (C) 2010 Some Name <some@example.org> +Copyright (C) 2011 Other Name <other@example.org> +</pre> + <p>Add another line:</p> + <pre>Copyright (C) 2010 Some Name <some@example.org> +Copyright (C) 2011 Other Name <other@example.org> +Copyright (C) YEAR Your Name <you@example.org> +</pre> + <p>For new files, copy one of the existing headers and start the copyright section with your name.</p> + <p>Also see + <a href="http://www.eclipse.org/legal/copyrightandlicensenotice.php" target="egit_external">http://www.eclipse.org/legal/copyrightandlicensenotice.php</a> for more information. + </p> + <h2 id="Test_before_submitting">Test before submitting</h2> + <p>See the + <a href="#Manual_alpha_testing">Manual alpha testing</a> section for some advice about how to test you work yourself. + </p> + <ul> + <li>Run all existing tests. It does not take very long.</li> + <li>Pay attention to the Java and Eclipse SDK baselines. EGit requires only Java5 and Eclipse 3.5. You cannot use API's that are newer. We often see breakages because Java 6 API's are used.</li> + </ul> + <p>Note: In order to test in Eclipse 3.5 (Galileo), consider building EGit with the <code>platform-galileo</code> maven profile (see the + <a href="Builds.html#Maven_Build_Sequence">Maven Build Sequence</a> for more details). + </p> + <h2 id="Sending_patches_by_mail">Sending patches by mail</h2> + <p>Although sending patches by mail is the approved way of interacting with, and asking feedback from, the Git project, please don't send patches via + <a href="http://www.kernel.org/pub//software/scm/git/docs/git-send-email.html" target="egit_external">git send-email</a>. Instead, please use + <a href="http://www.kernel.org/pub/software/scm/git/docs/git-format-patch.html" target="egit_external">git format-patch</a> to generate the <code>mbox</code>, and then attach that to an item in bugzilla as per the above SUBMITTING_PATCHES guides. + </p> + <p>If you're sending a work-in-progress for a review, be aware that you can also attach work-in-progress (or RFC) items to Bugzilla; it's not just for finished patches. </p> + <p> + <b>However</b>, it's generally preferred that you send items which you want comments on via Gerrit as per + <a href="#Contributing_Patches">Contributing_Patches</a>, since Gerrit allows comments to be added in-line and allows the opportunity to send multiple versions of a patch after changes are made. Once a change has been submitted to Gerrit, you can then mail the developer mailing list with a request to review your change via URL or get Gerrit to send the mail on your behalf. + </p> + <p> + <br/> + </p><hr/> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <td style="width: 20%" align="left"> + <a href="Website.html" title="Website"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"> + <a href="Contributor-Guide.html" title="EGit Contributor Guide"> + <img alt="EGit Contributor Guide" border="0" src="../../images/home.gif"/> + </a> + </td> + <td style="width: 20%" align="right"> + <a href="Gerrit-Code-Review-Cheatsheet.html" title="Gerrit Code Review Cheatsheet"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Website</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Gerrit Code Review Cheatsheet</td> + </tr> + </table> + </body> +</html>
\ No newline at end of file diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Contributor-Guide.html b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Contributor-Guide.html new file mode 100644 index 0000000000..b3316f1d10 --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Contributor-Guide.html @@ -0,0 +1,89 @@ +<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <title>EGit Contributor Guide</title> + <link type="text/css" rel="stylesheet" href="../../book.css"/> + </head> + <body> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <th style="width: 100%" align="center" colspan="3">EGit Contributor Guide</th> + </tr> + <tr> + <td style="width: 20%" align="left"></td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right"> + <a href="Obtaining-Sources.html" title="Obtaining Sources"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top"></td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Obtaining Sources</td> + </tr> + </table><hr/> + <h1 id="Communication">Communication</h1> + <table border="1" cellpadding="3" cellspacing="0"> + <tr> + <th>Channel</th> + <th>JGit</th> + <th>EGit </th> + </tr> + <tr> + <td>Developer Mailing List</td> + <td> + <a href="https://dev.eclipse.org/mailman/listinfo/jgit-dev" target="egit_external">JGit developer mailing list</a> + </td> + <td> + <a href="https://dev.eclipse.org/mailman/listinfo/egit-dev" target="egit_external">EGit developer mailing list</a> + </td> + </tr> + <tr> + <td>Build Notices Mailing List</td> + <td> + <a href="https://dev.eclipse.org/mailman/listinfo/jgit-build" target="egit_external">JGit build notices mailing list</a> + </td> + <td> + <a href="https://dev.eclipse.org/mailman/listinfo/egit-build" target="egit_external">EGit build notices mailing list</a> + </td> + </tr> + <tr> + <td>Reporting Bugs</td> + <td> + <a href="https://bugs.eclipse.org/bugs/enter_bug.cgi?product=JGit&rep_platform=All&op_sys=All" target="egit_external">File new JGit bug</a> + </td> + <td> + <a href="https://bugs.eclipse.org/bugs/enter_bug.cgi?product=EGit&rep_platform=All&op_sys=All" target="egit_external">File new EGit bug</a> + </td> + </tr> + <tr> + <td>User Forum</td> + <td> + <a href="http://www.eclipse.org/forums/index.php?t=thread&frm_id=48" target="egit_external">EGit User Forum</a> + </td> + </tr> + </table> + <p> + <br/> + </p><hr/> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <td style="width: 20%" align="left"></td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right"> + <a href="Obtaining-Sources.html" title="Obtaining Sources"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top"></td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Obtaining Sources</td> + </tr> + </table> + </body> +</html>
\ No newline at end of file diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Development-IDE-Configuration.html b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Development-IDE-Configuration.html new file mode 100644 index 0000000000..d9dec5ef32 --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Development-IDE-Configuration.html @@ -0,0 +1,152 @@ +<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <title>EGit Contributor Guide - Development IDE Configuration</title> + <link type="text/css" rel="stylesheet" href="../../book.css"/> + </head> + <body> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <th style="width: 100%" align="center" colspan="3">Development IDE Configuration</th> + </tr> + <tr> + <td style="width: 20%" align="left"> + <a href="Obtaining-Sources.html" title="Obtaining Sources"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right"> + <a href="Builds.html" title="Builds"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Obtaining Sources</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Builds</td> + </tr> + </table><hr/> + <h1 id="Development_IDE_Configuration">Development IDE Configuration</h1> + <p>Download and install "Eclipse for RCP and RAP Developers" from here, if you don't already have it:</p> + <p> + <a href="http://www.eclipse.org/downloads/" target="egit_external">http://www.eclipse.org/downloads/</a> + </p> + <h2 id="Tools">Tools</h2> + <p> + <b>Note:</b> You have to use at least Eclipse 4.3.2 (Kepler SR2), earlier versions had a bug where the following did not work (see + <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=409073" target="egit_external">bug 409073</a>). + </p> + <p>To install all the necessary tools to work on EGit/JGit, there is a + <a href="http://git.eclipse.org/c/egit/egit.git/plain/tools/egit-developer-tools.p2f" target="egit_external">egit-developer-tools.p2f</a> file which you can use as follows: + </p> + <ul> + <li>File > Import > Install > Install Software Items from File</li> + <li>Browse... + <ul> + <li>Go to the location of your egit repository, open the + <i>tools</i> directory and select + <i>egit-developer-tools.p2f</i> + </li> + <li>Alternatively, if you only want to contribute to JGit, download the file from the above link and select it</li> + </ul> + </li> + <li>All the items you don't already have should be selected automatically</li> + <li>Finish the wizard</li> + <li>Restart</li> + </ul> + <h2 id="Java_Requirements">Java Requirements</h2> + <p>EGit and JGit have Java 5.0 and + <a href="https://wiki.eclipse.org/EGit/FAQ#What_versions_of_Eclipse_does_EGit_target.3F" target="egit_external">Eclipse Platform 3.8.2 (Juno)</a> as minimum requirements, so dependencies to newer Java and platform versions must be avoided. + </p> + <p>We are using + <i>PDE/API Tools Environment Descriptions</i> (see changes for + <a href="https://git.eclipse.org/r/#/c/4785/" target="egit_external">JGit</a> and + <a href="https://git.eclipse.org/r/#/c/4365/" target="egit_external">EGit</a>) to facilitate detecting code which isn't working on Java 5. If you followed the instructions in the + <i>Tools</i> section above, the necessary descriptions should already be installed. Otherwise install + <i>PDE/API Tools Environment Descriptions</i> from the release train repository, see + <a href="http://wiki.eclipse.org/Execution_Environments#Installing_Execution_Environment_Descriptions" title="Execution_Environments#Installing_Execution_Environment_Descriptions" target="egit_external">Installing Execution Environment Descriptions</a>. + </p> + <h2 id="Dependencies">Dependencies</h2> + <p>After importing the EGit and JGit projects in Eclipse, they will not compile due to missing dependencies. There are a few ways to install these.</p> + <h3 id="Option_1:_Use_a_Target_Platform">Option 1: Use a Target Platform</h3> + <p> + <img align="right" title="EGit target platforms in org.eclipse.egit.target" alt="EGit target platforms in org.eclipse.egit.target" border="0" src="images/EGit-Target-Platforms.png‎"/> + </p> + <p>This is the easiest method to install dependencies:</p> + <ul> + <li>Open the + <i>org.eclipse.egit.target</i> project + </li> + <li>Choose the + <i>egit-<version>.target</i> file matching the version of your Eclipse platform (e.g. 4.2 for Juno) and open it (this may take a while as it downloads the indexes of the p2 repositories the target platform refers to) + </li> + <li>In the resulting editor, click on the + <i>Set as Target Platform</i> link at the top right (this may also take a while) + </li> + </ul> + <p>After that, the workspace should build cleanly. If not, try Project > Clean... > All. If this also doesn't help open Preferences > Plug-In Development > Target Platform, + select the checked target platform and click "Reload..." this will flush PDE's bundle cache and re-download the artifacts listed in the target platform.</p> + <p>There are different target definitions, one for each version of Eclipse that EGit supports. The one you select will be the one that is started if you want to try out a feature or bug fix.</p> + <p>You can always switch between them to test on different Eclipse versions. E.g. when you are developing some major UI functionality, you should try it with the oldest supported Eclipse release to make sure it doesn't depend on API that is only available in later versions.</p> + <h3 id="Option_2:_Install_from_Orbit_P2_Repository">Option 2: Install from Orbit P2 Repository</h3> + <p>Install the dependencies from the Orbit p2 repository by importing the p2f file described + <a href="#Tools">above</a>. + </p> + <p>If you want to try another Orbit p2 repository version on the + <a href="http://download.eclipse.org/tools/orbit/downloads/" target="egit_external">Orbit Downloads</a> page, click on the newest recommended build (R-Build) and copy the update site link from "Orbit Build Repository" (it should end with <tt>/repository</tt>). Add this update site in Eclipse using "Install New Software..." and then find and select the following entries: + </p> + <ul> + <li>Java Mocking and Stubbing Framework</li> + <li>Args4j</li> + <li>Protocol Buffers</li> + <li>Apache Jakarta log4j Plug-in</li> + <li>Apache Commons Compress</li> + <li>XZ Data Compression</li> + <li>Hamcrest Library of Matchers</li> + <li>JavaEWAH</li> + </ul> + <h2 id="Running">Running</h2> + <p>Now that everything builds, the next step is to run an Eclipse instance with the EGit/JGit code of the workspace:</p> + <ul> + <li>Right click on the + <i>org.eclipse.egit.ui</i> project + </li> + <li>Debug As > Eclipse Application</li> + </ul> + <p>This should create a new launch configuration and start a new nested Eclipse instance in debug mode. The created launch configuration can be edited, e.g. to change where the workspace of the nested Eclipse should be located.</p> + <p>The launch configuration can also be used in normal (non-debug) mode of course.</p> + <p>Also see the + <a href="http://help.eclipse.org/juno/topic/org.eclipse.pde.doc.user/guide/tools/launchers/eclipse_application_launcher.htm" target="egit_external">reference on eclipse application launchers</a>. + </p> + <p> + <br/> + </p><hr/> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <td style="width: 20%" align="left"> + <a href="Obtaining-Sources.html" title="Obtaining Sources"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"> + <a href="Contributor-Guide.html" title="EGit Contributor Guide"> + <img alt="EGit Contributor Guide" border="0" src="../../images/home.gif"/> + </a> + </td> + <td style="width: 20%" align="right"> + <a href="Builds.html" title="Builds"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Obtaining Sources</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Builds</td> + </tr> + </table> + </body> +</html>
\ No newline at end of file diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Documentation.html b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Documentation.html new file mode 100644 index 0000000000..68adb9f49d --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Documentation.html @@ -0,0 +1,80 @@ +<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <title>EGit Contributor Guide - Documentation</title> + <link type="text/css" rel="stylesheet" href="../../book.css"/> + </head> + <body> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <th style="width: 100%" align="center" colspan="3">Documentation</th> + </tr> + <tr> + <td style="width: 20%" align="left"> + <a href="Builds.html" title="Builds"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right"> + <a href="Tests.html" title="Tests"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Builds</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Tests</td> + </tr> + </table><hr/> + <h1 id="Documentation">Documentation</h1> + <p>The EGit project sources its documentation from the wiki and generates Eclipse help content from it (under the covers, we are using + <a href="http://wiki.eclipse.org/Mylyn/WikiText" target="egit_external">Mylyn WikiText</a> to make this possible). This significantly lowers the barrier for people to contribute documentation to the EGit project. To contribute documentation, simply modify the + <a href="http://wiki.eclipse.org/EGit/User_Guide" target="egit_external">EGit User's Guide</a>. Have a look at the + <a href="http://wiki.eclipse.org/DocumentationGuidelines/StyleGuidelines" title="DocumentationGuidelines/StyleGuidelines" target="egit_external">Style Guidelines</a> and + <a href="http://wiki.eclipse.org/Eclipse_Doc_Style_Guide" title="Eclipse_Doc_Style_Guide" target="egit_external">Eclipse Documentation Style Guide</a> to get some guidance on how to write good documentation. More on that can be found + <a href="http://wiki.eclipse.org/DocumentationGuidelines" title="DocumentationGuidelines" target="egit_external">here</a>. + </p> + <p>The documentation is contained in the + <b>org.eclipse.egit.doc</b> plug-in. The + <b>build-help.xml</b> drives the generation of the help content. It is integrated into the maven build. The regular maven build of + <b>org.eclipse.egit.doc</b> + </p> + <pre><b>$ mvn clean install</b> +</pre> + <p>will only package the help content committed to the egit repository. To update the help content by downloading the latest documentation from the wiki run</p> + <pre><b>$ mvn clean install -Dupdate.egit.doc</b> +</pre> + <p>Don't forget to check all the generated help pages and especially all hyperlinks and images before pushing the updated help to the code review system for inclusion into the continuous build.</p> + <p>The aim is to generate new documentation every month or so (or just on demand). If you're making big changes or want the documentation refreshed, please let us know on the egit-dev mailing list.</p> + <p> + <br/> + </p><hr/> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <td style="width: 20%" align="left"> + <a href="Builds.html" title="Builds"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"> + <a href="Contributor-Guide.html" title="EGit Contributor Guide"> + <img alt="EGit Contributor Guide" border="0" src="../../images/home.gif"/> + </a> + </td> + <td style="width: 20%" align="right"> + <a href="Tests.html" title="Tests"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Builds</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Tests</td> + </tr> + </table> + </body> +</html>
\ No newline at end of file diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html new file mode 100644 index 0000000000..72578abaaf --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html @@ -0,0 +1,182 @@ +<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <title>EGit Contributor Guide - Gerrit Code Review Cheatsheet</title> + <link type="text/css" rel="stylesheet" href="../../book.css"/> + </head> + <body> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <th style="width: 100%" align="center" colspan="3">Gerrit Code Review Cheatsheet</th> + </tr> + <tr> + <td style="width: 20%" align="left"> + <a href="Contributing-Patches.html" title="Contributing Patches"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right"> + <a href="Updating-This-Document.html" title="Updating This Document"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Contributing Patches</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Updating This Document</td> + </tr> + </table><hr/> + <h1 id="Gerrit_Code_Review_Cheatsheet">Gerrit Code Review Cheatsheet</h1> + <h2 id="Install_the_commit-msg_hook_in_your_repository">Install the commit-msg hook in your repository</h2> + <pre style="width: 60em;">scp -p -P 29418 username@git.eclipse.org:hooks/commit-msg .git/hooks/ +</pre> + <p> + This will ask for a password. It is the password that you have to generate in the + <i>SSH Keys</i> section of settings in your Gerrit account. + </p> + <p>You can alternatively + <a href="https://git.eclipse.org/r/tools/hooks/commit-msg" target="egit_external">download the file</a>. The + <a href="http://gerrit.googlecode.com/svn/documentation/2.1.2/cmd-hook-commit-msg.html" target="egit_external">hook</a> helps append a Change-Id to your commit message. + </p> + <p>EGit can also generate a Gerrit Change-Id into your commit message both + <a href="../../EGit/User_Guide/Tasks.html#Commit_Message" title="EGit/User_Guide#Commit_Message">manually</a> or in an + <a href="../../EGit/User_Guide/Tasks.html#Gerrit_Configuration" title="EGit/User_Guide#Gerrit_Configuration">automated</a> way. + </p> + <h2 id="To_create_a_new_change">To create a new change</h2> + <ul> + <li>JGit</li> + </ul> + <pre style="width: 60em;">git push ssh://username@git.eclipse.org:29418/jgit/jgit.git HEAD:refs/for/master +</pre> + <p> </p> + <ul> + <li>EGit</li> + </ul> + <pre style="width: 60em;">git push ssh://username@git.eclipse.org:29418/egit/egit.git HEAD:refs/for/master +</pre> + <p> + Or, if you've followed the instructions on + <a href="Contributing-Patches.html#Adding_a_dedicated_remote">Adding_a_dedicated_remote</a> you can simply do: + </p> + <pre style="width: 60em;">git push review +</pre> + <p> + Since the current repository has the right definition for 'review', you won't need to remember the canonical push URL</p> + <h2 id="To_update_an_existing_change_with_a_new_commit">To update an existing change with a new commit</h2> + <pre style="width: 60em;">git push ssh://username@git.eclipse.org:29418/egit/egit.git HEAD:refs/for/master +</pre> + <p> + This works because Gerrit links the new commit to the prior change based upon the Change-Id footer in the commit message. (This is automatically generated by the commit-msg hook you installed above.) If you refuse to use the commit-msg hook, or don't have a Change-Id footer, you should read the Gerrit documentation on + <a href="https://git.eclipse.org/r/Documentation/user-changeid.html" target="egit_external">change-id lines</a> and + <a href="https://git.eclipse.org/r/Documentation/user-upload.html#push_replace" target="egit_external">replacing changes</a>. + </p> + <p> + <b>Note:</b> To be picked up by Gerrit, a Change-Id line must be in the bottom portion (last paragraph) of a commit message, and may be mixed together with the Signed-off-by, Acked-by, or other such footers. So if your Change-Id line is ignored it's probably not in the last paragraph :). + </p> + <h2 id="To_compare_bulk_diffs_using_Git">To compare bulk diffs using Git</h2> + <p>Since each Gerrit review patchset actually commits its own tree, you can pull out the trees and compare them. </p> + <p>If you've got a large changeset, and you want to be able to do diffs between them via (command line) git instead of browsing on the web, then you can fetch the individual changes and then perform a diff. For example, + <a href="http://git.eclipse.org/r/2" target="egit_external">http://git.eclipse.org/r/2</a> shows the 'download' section for each patchset. In this case, it looks like: + </p> + <ul> + <li>Patch Set 1 <code>git pull ssh://username@git.eclipse.org/jgit refs/changes/02/2/1 (1d3331a91bd477d3f70cde9613576cf9688ac358)</code> </li> + <li>Patch Set 2 <code>git pull ssh://username@git.eclipse.org/jgit refs/changes/02/2/2 (13ab9a43d4d512963556a92e889b1204d32f8e68)</code> </li> + <li>Patch Set 3 <code>git pull ssh://username@git.eclipse.org/jgit refs/changes/02/2/3 (d14cc645655683ba3e30a35833fb2282142e898f)</code> </li> + <li>Patch Set 4 <code>git pull ssh://username@git.eclipse.org/jgit refs/changes/02/2/4 (43de8d385b614c72fd796e17da75d381f6e0cc25)</code></li> + </ul> + <p>Performing a <code>git pull</code> will both get the bits and merge them into your tree, which won't do what you want for comparison. So, in order to get the bits (but not merge), you need to do a <code>git fetch</code> instead. Let's say we want to diff the last two patches against each other rather than reviewing the entire patchset again: </p> + <pre>git fetch ssh://username@git.eclipse.org/jgit refs/changes/02/2/3 +git fetch ssh://username@git.eclipse.org/jgit refs/changes/02/2/4 + +git diff d14cc645655683ba3e30a35833fb2282142e898f 43de8d385b614c72fd796e17da75d381f6e0cc25 + +# or git diff d14cc6 43de8d +</pre> + <p> + If you're doing this from within an already checked out project, you can do <code>git fetch origin</code> (or any other remote name in <code>.git/config}</code>. </p> + <p>Git fetched data will stay around in your repository, but will be 'orphaned' if no references point to it. To clean up, you can run <code>git gc</code> or wait until this happens automatically.</p> + <h2 id="To_trigger_Hudson_build_for_a_change">To trigger Hudson build for a change</h2> + <p>We have build jobs + <b>jgit.gerrit</b>, + <b>egit.gerrit</b> and + <b>egit-github.gerrit</b> on + <a href="https://hudson.eclipse.org/egit/" target="egit_external">https://hudson.eclipse.org/egit/</a> which are triggered automatically when a new change or a new patchset for an existing change is pushed for review. These jobs will comment on the respective change when the build is started and when it's finished and vote on the change according to the build and test results. + </p> + <p>Sometimes you may want to retrigger such a build e.g. because it may have failed due to some temporary problem. + Committers can manually trigger these jobs in the following way:</p> + <ul> + <li>Go to + <a href="https://hudson.eclipse.org/sandbox/gerrit_manual_trigger/" target="egit_external">Trigger a Gerrit event manually</a> page + </li> + <li>Search for a change you'd like to build</li> + <li>Select the patch set(s) you want to trigger</li> + <li>Press + <b>Trigger Selected</b> button + </li> + </ul> + <p>If you are not a committer and need to retrigger a build ask for that on the mailing list.</p> + <h2 id="To_approve_a_change">To approve a change</h2> + <ul> + <li>Click on Publish Comments </li> + <li>Vote with the radio buttons</li> + </ul> + <h2 id="To_add_a_reviewer">To add a reviewer</h2> + <p>Once you've pushed your commit to Gerrit for review, you can go to the web page ( + <a href="https://git.eclipse.org/r/" target="egit_external">https://git.eclipse.org/r/</a>) and see your changes. By clicking on the review, there's an option to add a reviewer by e-mail address; they'll then be sent a message indicating that they'd like your review on the item. + </p> + <p>It's usually not necessary to add any reviewers, it should be reviewed by the committers sooner or later. If this hasn't happened, you can look for people that did changes in the same area and add them as reviewers. It's also ok to comment on a change to "bump" its visibility.</p> + <h2 id="Code_Review">Code Review</h2> + <p>The code review category indicates your opinion on the quality of the code, and how well it fits within the purpose of the existing surrounding code. A +2 vote from any committer is required before submission can occur. A -2 vote from any committer will block submission. </p> + <h2 id="IP_Review">IP Review</h2> + <p>The IP review category indicates whether or not the change has been properly logged under the + <a href="http://www.eclipse.org/legal/EclipseLegalProcessPoster.pdf" target="egit_external">Eclipse IP Process</a>. Under that process, any committer should mark his/her change +1 if they were the sole author of the change. For any other change, a committer should only mark +1 after ensuring the + <a href="Contributing-Patches.html#Legal_Paperwork">Legal Paperwork</a> has been done. A +1 vote is required to submit a change, while a -1 vote will block submission. + </p> + <h2 id="Submission_Guidelines">Submission Guidelines</h2> + <p>We strive to use Gerrit to improve our understanding of the code base and improve quality. </p> + <p>In order to ensure a proper review happens, some simple guidelines should be followed:</p> + <ul> + <li>vote 0/-1 for not-ready-to-submit (AKA WIP) own proposals, +1 otherwise;</li> + <li>If a changeset is not-ready-to-submit, please put + <a href="RFC">RFC</a> or + <a href="DRAFT">DRAFT</a> in the message to let people know + </li> + <li>let non-trivial changes be in review for at least 24 hours</li> + <li>if you want your changeset reviewed by someone, please add them as a reviewer</li> + </ul> + <h2 id="Tips_.26_Tricks">Tips & Tricks</h2> + <h3 id="Class_Loading_Issues">Class Loading Issues</h3> + <p>If you encounter strange class loading issues during runtime (e.g. on UI test executions) the following might help:</p> + <p>Enable tracing in your launch configuration to get information how imported packages are resolved at runtime. Select the Tracing tab in your launch configuration, select "Enable tracing", select plug-in org.eclipse.osgi, select category resolver/wiring on the right side.</p> + <p> + <a href="http://wiki.eclipse.org/Category:Draft_Documentation" title="Category:Draft_Documentation" target="egit_external">Category:Draft_Documentation</a> + </p><hr/> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <td style="width: 20%" align="left"> + <a href="Contributing-Patches.html" title="Contributing Patches"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"> + <a href="Contributor-Guide.html" title="EGit Contributor Guide"> + <img alt="EGit Contributor Guide" border="0" src="../../images/home.gif"/> + </a> + </td> + <td style="width: 20%" align="right"> + <a href="Updating-This-Document.html" title="Updating This Document"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Contributing Patches</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Updating This Document</td> + </tr> + </table> + </body> +</html>
\ No newline at end of file diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Obtaining-Sources.html b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Obtaining-Sources.html new file mode 100644 index 0000000000..b3225b2cca --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Obtaining-Sources.html @@ -0,0 +1,120 @@ +<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <title>EGit Contributor Guide - Obtaining Sources</title> + <link type="text/css" rel="stylesheet" href="../../book.css"/> + </head> + <body> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <th style="width: 100%" align="center" colspan="3">Obtaining Sources</th> + </tr> + <tr> + <td style="width: 20%" align="left"> + <a href="Contributor-Guide.html" title="EGit Contributor Guide"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right"> + <a href="Development-IDE-Configuration.html" title="Development IDE Configuration"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">EGit Contributor Guide</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Development IDE Configuration</td> + </tr> + </table><hr/> + <h1 id="Obtaining_Sources">Obtaining Sources</h1> + <p>EGit and JGit are self hosted in Git. You can browse the repositories on the web: + + <a href="http://git.eclipse.org/c/egit/" target="egit_external">EGit</a>, + <a href="http://git.eclipse.org/c/jgit/" target="egit_external">JGit</a> + </p> + <p>The first section below describes how to clone a repository and can be skipped if you have done this before.</p> + <p>The next section lists the repositories and their URLs.</p> + <h2 id="Cloning">Cloning</h2> + <h3 id="On_the_command_line">On the command line</h3> + <pre style="width: 40em;"> +git clone <enter URL> +</pre> + <p>After that, import the projects into Eclipse using Import > Existing Projects into Workspace.</p> + <h3 id="Using_EGit_.28see_.5Bhttp:.2F.2Fwww.eclipse.org.2Fegit.2Fdownload.2F_download_page.5D.29">Using EGit (see + <a href="http://www.eclipse.org/egit/download/" target="egit_external">download page</a>) + </h3> + <p>First, verify that the default repository folder as set on the main Git preference page is to your liking.</p> + <p>Then, clone the repository and import the projects:</p> + <ul> + <li>Open + <i>File</i> > + <i>Import...</i> and select + <i>Git</i> > + <i>Projects from Git</i> + </li> + <li>Selet + <i>URI</i> + </li> + <li>Enter the URL (see next section) </li> + <li>Import existing projects into the workspace from the newly created working directory</li> + </ul> + <h2 id="Repositories">Repositories</h2> + <p>To develop EGit, the EGit and JGit repositories are needed, the others are optional. To develop JGit, only JGit is needed. </p> + <h3 id="EGit">EGit</h3> + <p>URL: + <a href="https://git.eclipse.org/r/egit/egit.git" target="egit_external">https://git.eclipse.org/r/egit/egit.git</a> + </p> + <p>This is the main repository, where the standard EGit feature is developed. It contains the code for the UI and Eclipse integration.</p> + <h3 id="JGit">JGit</h3> + <p>URL: + <a href="https://git.eclipse.org/r/jgit/jgit.git" target="egit_external">https://git.eclipse.org/r/jgit/jgit.git</a> + </p> + <p>This is the Java implementation of Git used by EGit, for working with Git repositories.</p> + <h3 id="EGit_GitHub_Integration">EGit GitHub Integration</h3> + <p>URL: + <a href="https://git.eclipse.org/r/p/egit/egit-github.git" target="egit_external">https://git.eclipse.org/r/p/egit/egit-github.git</a> + </p> + <p>EGit also provides tools for integrating with GitHub and Mylyn tasks.</p> + <p>For getting the dependencies, open the file <code>org.eclipse.mylyn.github-feature/github.target</code> ( + <a href="http://git.eclipse.org/c/egit/egit-github.git/plain/org.eclipse.mylyn.github-feature/github.target" target="egit_external">view on web</a>) and select + <i>Set as Target Platfrom</i>. + </p> + <h3 id="EGit_PDE_Tools">EGit PDE Tools</h3> + <p>URL: + <a href="https://git.eclipse.org/r/egit/egit-pde.git" target="egit_external">https://git.eclipse.org/r/egit/egit-pde.git</a> + </p> + <p>EGit also provides tools for integrating with + <a href="http://wiki.eclipse.org/PDE/Build" title="PDE/Build" target="egit_external">PDE Build</a> and Eclipse RelEng Tools. If you are an Eclipse developer using PDE Build and/or the Eclipse RelEng tools you might be interesting in the following as well. Otherwise you might just skip this section. + </p> + <p>In addition to the + <a href="Development-IDE-Configuration.html#Dependencies">dependencies</a> required for JGit and EGit you also need Eclipse PDE (>= 3.6.1) as well as <code>org.eclipse.releng.tools</code> in your target platform or checked out from CVS in your workspaces. + </p><hr/> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <td style="width: 20%" align="left"> + <a href="Contributor-Guide.html" title="EGit Contributor Guide"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"> + <a href="Contributor-Guide.html" title="EGit Contributor Guide"> + <img alt="EGit Contributor Guide" border="0" src="../../images/home.gif"/> + </a> + </td> + <td style="width: 20%" align="right"> + <a href="Development-IDE-Configuration.html" title="Development IDE Configuration"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">EGit Contributor Guide</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Development IDE Configuration</td> + </tr> + </table> + </body> +</html>
\ No newline at end of file diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Tests.html b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Tests.html new file mode 100644 index 0000000000..3ff25984bd --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Tests.html @@ -0,0 +1,112 @@ +<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <title>EGit Contributor Guide - Tests</title> + <link type="text/css" rel="stylesheet" href="../../book.css"/> + </head> + <body> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <th style="width: 100%" align="center" colspan="3">Tests</th> + </tr> + <tr> + <td style="width: 20%" align="left"> + <a href="Documentation.html" title="Documentation"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right"> + <a href="Bugs.html" title="Bugs"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Documentation</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Bugs</td> + </tr> + </table><hr/> + <h1 id="Tests">Tests</h1> + <h2 id="JGit_Unit_Tests">JGit Unit Tests</h2> + <p>The JGit unit tests are executed during the maven build. + To run them from the Eclipse workbench use the launch configurations which are part of the sources of the test bundles'.</p> + <h2 id="JGit_HTTP_Tests">JGit HTTP Tests</h2> + <p>The JGit HTTP tests in + <i>org.eclipse.jgit.http.test</i> rely on the Jetty web container. + </p> + <p>To run these tests from Eclipse the Jetty feature is needed. Use one of the target platforms as described in + <a href="Development-IDE-Configuration.html#Dependencies">dependencies</a>. + </p> + <p>Alternatively, install "Jetty 7.6.11.v20130520" from + <a href="http://download.eclipse.org/jetty/updates/jetty-bundles-7.x/7.6.11.v20130520/" target="egit_external">http://download.eclipse.org/jetty/updates/jetty-bundles-7.x/7.6.11.v20130520/</a> . + </p> + <h2 id="EGit_Core_Tests">EGit Core Tests</h2> + <p>The EGit Core tests are executed during the maven build for the bundle + <i>org.eclipse.egit.core.test</i>. + </p> + <p>To run them from the Eclipse workbench use the launch configuration which is part of the sources of the test bundle + <i>org.eclipse.egit.core.test</i>. + </p> + <h2 id="EGit_UI_Tests">EGit UI Tests</h2> + <p>The EGit UI tests are using SWTBot, using the 'SWTBot for Eclipse Testing' feature.</p> + <p>You need to install at least "SWTBot for Eclipse Testing" and "SWTBot IDE Feature":</p> + <ul> + <li>Juno and Kepler: + <a href="http://download.eclipse.org/technology/swtbot/releases/2.1.0/" target="egit_external">http://download.eclipse.org/technology/swtbot/releases/2.1.0/</a> + </li> + </ul> + <p>Starting a UI test from Eclipse:</p> + <ul> + <li>select the test class or test method</li> + <li>click + <b>Run As > SWTBot Test</b> + </li> + </ul> + <p> + <img border="0" src="images/Start-swtbot-test.png"/> + </p> + <p>Do not touch the mouse or keyboard when the UI test is running since this may + disturb the UI test by e.g. moving the current focus to another window.</p> + <h3 id="During_Maven_Build">During Maven Build</h3> + <p>The tests are executed in the integration-test phase of the + <a href="http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html" target="egit_external">default Maven lifecycle</a>. + </p> + <p>If you want to skip execution of UI tests (only execute core tests):</p> + <pre>mvn -P skip-ui-tests clean install +</pre> + <p>If you want to skip all tests:</p> + <pre>mvn clean install -Dmaven.test.skip=true +</pre> + <h2 id="Auxilary_testing_tools">Auxilary testing tools</h2> + <p>Any code, including testing code, does not always do what you expected it to. The most common failure is probably the failure to actually execute the part of the code you wanted to test. Code coverage tools like + <a href="http://www.eclemma.org/" target="egit_external">EclEmma</a> can easily visualize what part of the code is being executed. + </p><hr/> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <td style="width: 20%" align="left"> + <a href="Documentation.html" title="Documentation"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"> + <a href="Contributor-Guide.html" title="EGit Contributor Guide"> + <img alt="EGit Contributor Guide" border="0" src="../../images/home.gif"/> + </a> + </td> + <td style="width: 20%" align="right"> + <a href="Bugs.html" title="Bugs"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Documentation</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Bugs</td> + </tr> + </table> + </body> +</html>
\ No newline at end of file diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Updating-This-Document.html b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Updating-This-Document.html new file mode 100644 index 0000000000..bd2e004dc2 --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Updating-This-Document.html @@ -0,0 +1,55 @@ +<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <title>EGit Contributor Guide - Updating This Document</title> + <link type="text/css" rel="stylesheet" href="../../book.css"/> + </head> + <body> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <th style="width: 100%" align="center" colspan="3">Updating This Document</th> + </tr> + <tr> + <td style="width: 20%" align="left"> + <a href="Gerrit-Code-Review-Cheatsheet.html" title="Gerrit Code Review Cheatsheet"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right"></td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Gerrit Code Review Cheatsheet</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top"></td> + </tr> + </table><hr/> + <h1 id="Updating_This_Document">Updating This Document</h1> + <p> This document is maintained in a collaborative wiki. If you wish to + update or modify this document please visit + + <a href="http://wiki.eclipse.org/EGit/Contributor_Guide" target="egit_external">http://wiki.eclipse.org/EGit/Contributor_Guide</a> + </p><hr/> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <td style="width: 20%" align="left"> + <a href="Gerrit-Code-Review-Cheatsheet.html" title="Gerrit Code Review Cheatsheet"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"> + <a href="Contributor-Guide.html" title="EGit Contributor Guide"> + <img alt="EGit Contributor Guide" border="0" src="../../images/home.gif"/> + </a> + </td> + <td style="width: 20%" align="right"></td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Gerrit Code Review Cheatsheet</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top"></td> + </tr> + </table> + </body> +</html>
\ No newline at end of file diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Website.html b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Website.html new file mode 100644 index 0000000000..5e08f9352f --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/Website.html @@ -0,0 +1,100 @@ +<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> + <title>EGit Contributor Guide - Website</title> + <link type="text/css" rel="stylesheet" href="../../book.css"/> + </head> + <body> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <th style="width: 100%" align="center" colspan="3">Website</th> + </tr> + <tr> + <td style="width: 20%" align="left"> + <a href="Bugs.html" title="Bugs"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right"> + <a href="Contributing-Patches.html" title="Contributing Patches"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Bugs</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Contributing Patches</td> + </tr> + </table><hr/> + <h1 id="Website">Website</h1> + <p>The EGit and JGit websites are located in Git repositories which are configured for Gerrit code review.</p> + <p> + <b>egit</b> + </p> + <ul> + <li>File > Import > Git > Projects from Git</li> + <li>Select URL + <ul> + <li>HTTPS protocol: + <b> + <a href="https://git.eclipse.org/r/p/www.eclipse.org/egit.git" target="egit_external">https://git.eclipse.org/r/p/www.eclipse.org/egit.git</a> + </b> + </li> + <li>SSH protocol: + <b>ssh://user@git.eclipse.org:29418/www.eclipse.org/egit.git</b> + </li> + </ul> + </li> + <li>in Repositories View on node "origin" click "Gerrit Configuration..." and select branch "master", then changes you push to upstream will end up in Gerrit for review and can be submitted there</li> + </ul> + <p> + <b>jgit</b> + </p> + <ul> + <li>File > Import > Git > Projects from Git</li> + <li>Select URL + <ul> + <li>HTTP protocol: + <b> + <a href="https://git.eclipse.org/r/p/www.eclipse.org/jgit.git" target="egit_external">https://git.eclipse.org/r/p/www.eclipse.org/jgit.git</a> + </b> + </li> + <li>SSH protocol: + <b>ssh://user@git.eclipse.org:29418/www.eclipse.org/jgit.git</b> + </li> + </ul> + </li> + <li>in Repositories View on node "origin" click "Gerrit Configuration..." and select branch "master", then changes you push to upstream will end up in Gerrit for review and can be submitted there</li> + </ul> + <p> + <br/> + </p><hr/> + <table class="navigation" style="width: 100%;" border="0" summary="navigation"> + <tr> + <td style="width: 20%" align="left"> + <a href="Bugs.html" title="Bugs"> + <img alt="Previous" border="0" src="../../images/prev.gif"/> + </a> + </td> + <td style="width: 60%" align="center"> + <a href="Contributor-Guide.html" title="EGit Contributor Guide"> + <img alt="EGit Contributor Guide" border="0" src="../../images/home.gif"/> + </a> + </td> + <td style="width: 20%" align="right"> + <a href="Contributing-Patches.html" title="Contributing Patches"> + <img alt="Next" border="0" src="../../images/next.gif"/> + </a> + </td> + </tr> + <tr> + <td style="width: 20%" align="left" valign="top">Bugs</td> + <td style="width: 60%" align="center"></td> + <td style="width: 20%" align="right" valign="top">Contributing Patches</td> + </tr> + </table> + </body> +</html>
\ No newline at end of file diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/images/EGit-Target-Platforms.png b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/images/EGit-Target-Platforms.png Binary files differnew file mode 100644 index 0000000000..d619e6915c --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/images/EGit-Target-Platforms.png diff --git a/org.eclipse.egit.doc/help/EGit/Contributor_Guide/images/Start-swtbot-test.png b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/images/Start-swtbot-test.png Binary files differnew file mode 100644 index 0000000000..0309b2de81 --- /dev/null +++ b/org.eclipse.egit.doc/help/EGit/Contributor_Guide/images/Start-swtbot-test.png diff --git a/org.eclipse.egit.doc/help/JGit/User_Guide/User-Guide.html b/org.eclipse.egit.doc/help/JGit/User_Guide/User-Guide.html index 3324bfb444..011be6415a 100644 --- a/org.eclipse.egit.doc/help/JGit/User_Guide/User-Guide.html +++ b/org.eclipse.egit.doc/help/JGit/User_Guide/User-Guide.html @@ -36,7 +36,7 @@ <p>You are probably familiar with the git command line interface (CLI) that can be used from the shell or in scripts. JGit comes with its own small CLI, which, although not as feature-full as the git CLI, is a good way to showcase what JGIt can do. Furthermore, the programs serve as an excellent source of inspiration for how to accomplish different tasks. </p> <h3 id="Building_the_JGit_CLI">Building the JGit CLI</h3> <p>Assuming that you have the EGit git repository cloned and ready, build the jgit binary by running the jgit maven build (see - <a href="http://wiki.eclipse.org/EGit/Contributor_Guide#JGit" title="EGit/Contributor_Guide#JGit" target="egit_external">the Contributor Guide</a>): + <a href="../../EGit/Contributor_Guide/Obtaining-Sources.html#JGit" title="EGit/Contributor_Guide#JGit">the Contributor Guide</a>): </p> <pre>~/src/jgit$ mvn clean install </pre> diff --git a/org.eclipse.egit.doc/help/toc.xml b/org.eclipse.egit.doc/help/toc.xml index f2d99f4b76..2c9e2fd84a 100644 --- a/org.eclipse.egit.doc/help/toc.xml +++ b/org.eclipse.egit.doc/help/toc.xml @@ -478,4 +478,103 @@ <topic href="help/EGit/Git_For_Eclipse_Users/Git-For-Eclipse-Users.html#Rebasing_and_fast-forwarding" label="Rebasing and fast-forwarding"></topic> <topic href="help/EGit/Git_For_Eclipse_Users/Updating-This-Document.html" label="Updating This Document"></topic> </topic> + <topic href="help/EGit/Contributor_Guide/Contributor-Guide.html" label="EGit Contributor Guide"> + <topic href="help/EGit/Contributor_Guide/Contributor-Guide.html" label="Communication"></topic> + <topic href="help/EGit/Contributor_Guide/Obtaining-Sources.html" label="Obtaining Sources"> + <topic href="help/EGit/Contributor_Guide/Obtaining-Sources.html#Cloning" label="Cloning"> + <topic href="help/EGit/Contributor_Guide/Obtaining-Sources.html#On_the_command_line" label="On the command line"></topic> + <topic href="help/EGit/Contributor_Guide/Obtaining-Sources.html#Using_EGit_.28see_.5Bhttp:.2F.2Fwww.eclipse.org.2Fegit.2Fdownload.2F_download_page.5D.29" label="Using EGit (see [http://www.eclipse.org/egit/download/ download page])"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Obtaining-Sources.html#Repositories" label="Repositories"> + <topic href="help/EGit/Contributor_Guide/Obtaining-Sources.html#EGit" label="EGit"></topic> + <topic href="help/EGit/Contributor_Guide/Obtaining-Sources.html#JGit" label="JGit"></topic> + <topic href="help/EGit/Contributor_Guide/Obtaining-Sources.html#EGit_GitHub_Integration" label="EGit GitHub Integration"></topic> + <topic href="help/EGit/Contributor_Guide/Obtaining-Sources.html#EGit_PDE_Tools" label="EGit PDE Tools"></topic> + </topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Development-IDE-Configuration.html" label="Development IDE Configuration"> + <topic href="help/EGit/Contributor_Guide/Development-IDE-Configuration.html#Tools" label="Tools"></topic> + <topic href="help/EGit/Contributor_Guide/Development-IDE-Configuration.html#Java_Requirements" label="Java Requirements"></topic> + <topic href="help/EGit/Contributor_Guide/Development-IDE-Configuration.html#Dependencies" label="Dependencies"> + <topic href="help/EGit/Contributor_Guide/Development-IDE-Configuration.html#Option_1:_Use_a_Target_Platform" label="Option 1: Use a Target Platform"></topic> + <topic href="help/EGit/Contributor_Guide/Development-IDE-Configuration.html#Option_2:_Install_from_Orbit_P2_Repository" label="Option 2: Install from Orbit P2 Repository"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Development-IDE-Configuration.html#Running" label="Running"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Builds.html" label="Builds"> + <topic href="help/EGit/Contributor_Guide/Builds.html#JGit_2" label="JGit"></topic> + <topic href="help/EGit/Contributor_Guide/Builds.html#EGit_2" label="EGit"></topic> + <topic href="help/EGit/Contributor_Guide/Builds.html#Mailing_Lists" label="Mailing Lists"></topic> + <topic href="help/EGit/Contributor_Guide/Builds.html#Maven_Build_Sequence" label="Maven Build Sequence"></topic> + <topic href="help/EGit/Contributor_Guide/Builds.html#FindBugs_and_PMD" label="FindBugs and PMD"></topic> + <topic href="help/EGit/Contributor_Guide/Builds.html#Checking_for_JGit_API_Changes_using_API_Baseline" label="Checking for JGit API Changes using API Baseline"></topic> + <topic href="help/EGit/Contributor_Guide/Builds.html#Automated_Signing_and_Publishing" label="Automated Signing and Publishing"> + <topic href="help/EGit/Contributor_Guide/Builds.html#Signing_.28old_method.2C_replaced_by_automated_procedure.29" label="Signing (old method, replaced by automated procedure)"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Builds.html#Contribution_to_Release_Train" label="Contribution to Release Train"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Documentation.html" label="Documentation"></topic> + <topic href="help/EGit/Contributor_Guide/Tests.html" label="Tests"> + <topic href="help/EGit/Contributor_Guide/Tests.html#JGit_Unit_Tests" label="JGit Unit Tests"></topic> + <topic href="help/EGit/Contributor_Guide/Tests.html#JGit_HTTP_Tests" label="JGit HTTP Tests"></topic> + <topic href="help/EGit/Contributor_Guide/Tests.html#EGit_Core_Tests" label="EGit Core Tests"></topic> + <topic href="help/EGit/Contributor_Guide/Tests.html#EGit_UI_Tests" label="EGit UI Tests"> + <topic href="help/EGit/Contributor_Guide/Tests.html#During_Maven_Build" label="During Maven Build"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Tests.html#Auxilary_testing_tools" label="Auxilary testing tools"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Bugs.html" label="Bugs"> + <topic href="help/EGit/Contributor_Guide/Bugs.html#Links" label="Links"> + <topic href="help/EGit/Contributor_Guide/Bugs.html#Filing_Bugs" label="Filing Bugs"></topic> + <topic href="help/EGit/Contributor_Guide/Bugs.html#Bug_Reports_and_Links" label="Bug Reports and Links"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Bugs.html#Keywords" label="Keywords"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Website.html" label="Website"></topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html" label="Contributing Patches"> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Using_Gerrit_at_Eclipse" label="Using Gerrit at Eclipse"> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#User_Account" label="User Account"></topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Legal_Paperwork" label="Legal Paperwork"></topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Logon" label="Logon"> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Gerrit_Web_UI" label="Gerrit Web UI"></topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Git_over_SSH" label="Git over SSH"></topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Git_over_HTTPS" label="Git over HTTPS"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#SSH_Keys" label="SSH Keys"></topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Doing_Code_Reviews_with_Gerrit" label="Doing Code Reviews with Gerrit"></topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Using_Gerrit_with_git_command_line:" label="Using Gerrit with git command line:"> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Adding_a_dedicated_remote" label="Adding a dedicated remote"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Using_Gerrit_with_EGit:" label="Using Gerrit with EGit:"></topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Using_the_Mylyn_Gerrit_Connector" label="Using the Mylyn Gerrit Connector"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Granularity_of_Changes" label="Granularity of Changes"> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Branches" label="Branches"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Coding_standards" label="Coding standards"> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Braces_for_one-line_statements" label="Braces for one-line statements"></topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Removing_trailing_whitespace" label="Removing trailing whitespace"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Commit_message_guidelines" label="Commit message guidelines"></topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Copyright" label="Copyright"></topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Test_before_submitting" label="Test before submitting"></topic> + <topic href="help/EGit/Contributor_Guide/Contributing-Patches.html#Sending_patches_by_mail" label="Sending patches by mail"></topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html" label="Gerrit Code Review Cheatsheet"> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html#Install_the_commit-msg_hook_in_your_repository" label="Install the commit-msg hook in your repository"></topic> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html#To_create_a_new_change" label="To create a new change"></topic> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html#To_update_an_existing_change_with_a_new_commit" label="To update an existing change with a new commit"></topic> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html#To_compare_bulk_diffs_using_Git" label="To compare bulk diffs using Git"></topic> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html#To_trigger_Hudson_build_for_a_change" label="To trigger Hudson build for a change"></topic> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html#To_approve_a_change" label="To approve a change"></topic> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html#To_add_a_reviewer" label="To add a reviewer"></topic> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html#Code_Review" label="Code Review"></topic> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html#IP_Review" label="IP Review"></topic> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html#Submission_Guidelines" label="Submission Guidelines"></topic> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html#Tips_.26_Tricks" label="Tips & Tricks"> + <topic href="help/EGit/Contributor_Guide/Gerrit-Code-Review-Cheatsheet.html#Class_Loading_Issues" label="Class Loading Issues"></topic> + </topic> + </topic> + <topic href="help/EGit/Contributor_Guide/Updating-This-Document.html" label="Updating This Document"></topic> + </topic> </toc>
\ No newline at end of file |
