Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
EGit/Contributor Guide
This page is currently under construction. Community members are encouraged to maintain the page, and make sure the information is accurate.
| EGit | |
| Website | |
| Download | |
| Community | |
| Mailing List • Forums • IRC • mattermost | |
| Issues | |
| Open • Help Wanted • Bug Day | |
| Contribute | |
| Browse Source • Project Set File |
Contents
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
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
- Paste 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
Contributing Patches
Review the following style guides:
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
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.