documentation/proposeCommitPatch.html

<div id="midcolumn">
<h1>Proposing and Committing a Patch</h1>

<p>The patch file contains a description of changes of a set of
resources which can be automatically applied to another eclipse
workspace or git repository. If you want to propose or commit a patch
you need to know that the Eclipse update hook will examine the
Committer's entries of an incoming push. All the committer's entries
have to be made by the committer performing the push, otherwise the push
will fail. Furthermore, your committer ID, or the committer e-mail
address registered with your committer account at the Eclipse Foundation
must be present in the Committer Email record. For more information on
that restriction see: <a
	href="http://wiki.eclipse.org/Git#Notes_on_DVCS">this</a> page.</p>

<h3>Proposing a Patch</h3>
<p>If you want commit a change on a local feature or bugfix branch
and then to export this change into a patch file, follow the steps
below:</p>
<ul>
	<li>Open a <a
		href="https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Libra">bug</a>
	<ul>
		<li>Specify the bug component (General; OSGi Facet or WAR)</li>
		<li>Complete the fields about the product version, bug severity,
		type of your hardware, operating systems and write a summary and
		description of the patch</li>
	</ul>
	</li>
	<li>Open the <b>History</b> view of your <b>Eclipse IDE</b> and
	choose <b>Create Patch...</b> (<i>The patch file will contain the
	difference between the commit and its parent in the history view. Note
	that the filter of the history view applies also for patch creation.</i>)</li>
	<li>Start the <b>Patch Wizard</b>, select the location of the
	patch and choose Next (<i>The name of the patch file is created
	from the first line of the commit message.</i>)</li>
	<li>Change the patch format, if necessary</li>
	<li>Attach the patch created to the bug</li>
	<li>Submit the bug</li>
</ul>



<h3>Committing a Patch</h3>
<p>To commit a patch, proceed as follows:</p>
<ul>
	<li>Apply the proposed patch using the <b>Patch Wizard</b></li>
	<li>Test the patch</li>
	<li>Commit the patch</li>
	<li><a
		href="http://wiki.eclipse.org/EGit/User_Guide#Push_Upstream">Setup
	push configuration</a> with the following push URL:
	<p><b>ssh://committer_id@git.eclipse.org/gitroot/libra/org.eclipse.libra.git</b></p>
	</li>
	<li>Push the patch and see its change number in order to be able
	to inspect it</li>
</ul>


<h3>How to reproduce a build to a certain change list</h3>
<p><a
	href="http://wiki.eclipse.org/EGit/User_Guide#Fetching_a_change_from_a_Gerrit_Code_Review_Server">Fetch
to the specific change</a> and build with Maven as described <a
	href="builds.php">here</a>.</p>


</div>