Revision as of 15:07, 6 October 2009

Draft Content
This page is currently under construction. Community members are encouraged to maintain the page, and make sure the information is accurate.

Obtaining Sources

EGit and JGit are currently self hosted in Git. To obtain a copy of each repository:

From the command line:

git clone git://egit.eclipse.org/egit/parallelip-jgit.git jgit
git clone git://egit.eclipse.org/egit/parallelip-egit.git egit

From an installed EGit plugin:

• File > Import > Git Repository
• Enter URL

git://egit.eclipse.org/egit/parallelip-jgit.git

• Import projects

• File > Import > Git Repository
• Enter URL

git://egit.eclipse.org/egit/parallelip-egit.git

• Import projects
• You may browse the repositories in gitweb

Contributing Patches

Review the following style guides:

• JGit SUBMITTING_PATCHES
• EGit SUBMITTING_PATCHES

Currently the project is alpha-testing Gerrit Code Review for Git based patch submission and review. To use the alpha testing instance hosted at eclipse.org:

• Register a user account
• Add one or more public SSH keys
• Execute SSH once to accept the host key (or copy it from the registration web page)

ssh -p 29418 username@egit.eclipse.org

• Upload your patch from Git to the target project:

git push ssh://username@egit.eclipse.org:29418/egit/parallelip-jgit.git HEAD:refs/for/master

• Visit our Gerrit Code Review instance to start reviewing

Or, create a new bug and attach a Git formatted patch file, as produced by the `git format-patch` tool.

Gerrit Code Review Cheatsheet

Install the commit-msg hook in your repository:

scp -p -P 29418 username@egit.eclipse.org:hooks/commit-msg .git/hooks

To create a new change:

git push ssh://username@egit.eclipse.org:29418/egit/parallelip-jgit.git HEAD:refs/for/master

To update an existing change with a new commit:

git push ssh://username@egit.eclipse.org:29418/egit/parallelip-jgit.git HEAD:refs/for/master

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 change-id lines and replacing changes.

Libraries from Orbit

com.jcraft.jsch

• File > Import > CVS > Projects from CVS
• Select URL :pserver:anonymous@dev.eclipse.org/cvsroot/tools
• Use module org.eclipse.orbit/com.jcraft.jsch
• Finish
• Right click on the project > Team > Switch to another branch
• Select tag from following list
• Refresh Tags
• Branches > v0_1_41

org.kohsuke.args4j

• File > Import > CVS > Projects from CVS
• Select URL :pserver:anonymous@dev.eclipse.org/cvsroot/tools
• Use module org.eclipse.orbit/org.kohsuke.args4j
• Finish
• Right click on the project > Team > Switch to another branch
• Select tag from following list
• Refresh Tags
• Branches > v2_0_12

javax.servlet

• File > Import > CVS > Projects from CVS
• Select URL :pserver:anonymous@dev.eclipse.org/cvsroot/tools
• Use module org.eclipse.orbit/javax.servlet
• Finish
• Right click on the project > Team > Switch to another branch
• Select tag from following list
• Refresh Tags
• Branches > v2_5_0