Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "EGit/FAQ"

(Where can I find older releases of EGit?)
(Where can I find older releases of EGit?)
Line 64: Line 64:
 
| [http://download.eclipse.org/egit/updates-3.6.2 http://download.eclipse.org/egit/updates-3.6.2]
 
| [http://download.eclipse.org/egit/updates-3.6.2 http://download.eclipse.org/egit/updates-3.6.2]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.6.2/&r=1 updates-3.6.2]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.6.2/&r=1 updates-3.6.2]
|
+
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.6.2/org.eclipse.egit.repository-3.6.2.201501210735-r.zip 3.6.2.201501210735-r]
 
|-
 
|-
 
| 3.6.1.201501031845-r
 
| 3.6.1.201501031845-r
Line 70: Line 70:
 
| [http://download.eclipse.org/egit/updates-3.6.1 http://download.eclipse.org/egit/updates-3.6.1]
 
| [http://download.eclipse.org/egit/updates-3.6.1 http://download.eclipse.org/egit/updates-3.6.1]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.6.1/&r=1 updates-3.6.1]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.6.1/&r=1 updates-3.6.1]
|
+
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.6.1/org.eclipse.egit.repository-3.6.1.201501031845-r.zip 3.6.1.201501031845-r]
 
|-
 
|-
 
| 3.6.0.201412230720-r
 
| 3.6.0.201412230720-r
Line 76: Line 76:
 
| [http://download.eclipse.org/egit/updates-3.6 http://download.eclipse.org/egit/updates-3.6]
 
| [http://download.eclipse.org/egit/updates-3.6 http://download.eclipse.org/egit/updates-3.6]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.6/&r=1 updates-3.6]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.6/&r=1 updates-3.6]
|
+
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.6/org.eclipse.egit.repository-3.6.0.201412230720-r.zip 3.6.0.201412230720-r]
 
|-
 
|-
 
| 3.5.3.201412180710-r
 
| 3.5.3.201412180710-r
Line 82: Line 82:
 
| [http://download.eclipse.org/egit/updates-3.5.3 http://download.eclipse.org/egit/updates-3.5.3]
 
| [http://download.eclipse.org/egit/updates-3.5.3 http://download.eclipse.org/egit/updates-3.5.3]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.5.3/&r=1 updates-3.5.3]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.5.3/&r=1 updates-3.5.3]
|
+
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.5.3/org.eclipse.egit.repository-3.5.3.201412180710-r.zip 3.5.3.201412180710-r]
 
|-
 
|-
 
| 3.5.2.201411120430-r
 
| 3.5.2.201411120430-r
Line 88: Line 88:
 
| [http://download.eclipse.org/egit/updates-3.5.2 http://download.eclipse.org/egit/updates-3.5.2]
 
| [http://download.eclipse.org/egit/updates-3.5.2 http://download.eclipse.org/egit/updates-3.5.2]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.5.2/&r=1 updates-3.5.2]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.5.2/&r=1 updates-3.5.2]
|
+
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.5.2/org.eclipse.egit.repository-3.5.2.201411120430-r.zip 3.5.2.201411120430-r]
 
|-
 
|-
 
| 3.5.1.201410131835-r
 
| 3.5.1.201410131835-r
Line 94: Line 94:
 
| [http://download.eclipse.org/egit/updates-3.5.1 http://download.eclipse.org/egit/updates-3.5.1]
 
| [http://download.eclipse.org/egit/updates-3.5.1 http://download.eclipse.org/egit/updates-3.5.1]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.5.1/&r=1 updates-3.5.1]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.5.1/&r=1 updates-3.5.1]
|
+
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.5.1/org.eclipse.egit.repository-3.5.1.201410131835-r.zip 3.5.1.201410131835-r]
 
|-
 
|-
 
| 3.5.0.201409260305-r
 
| 3.5.0.201409260305-r
Line 100: Line 100:
 
| [http://download.eclipse.org/egit/updates-3.5 http://download.eclipse.org/egit/updates-3.5]
 
| [http://download.eclipse.org/egit/updates-3.5 http://download.eclipse.org/egit/updates-3.5]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.5/&r=1 updates-3.5]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.5/&r=1 updates-3.5]
|
+
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.5/org.eclipse.egit.repository-3.5.0.201409260305-r.zip 3.5.0.201409260305-r]
 
|-
 
|-
 
| 3.4.2.201412180340-r
 
| 3.4.2.201412180340-r
Line 106: Line 106:
 
| [http://download.eclipse.org/egit/updates-3.4.2 http://download.eclipse.org/egit/updates-3.4.2]
 
| [http://download.eclipse.org/egit/updates-3.4.2 http://download.eclipse.org/egit/updates-3.4.2]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.4.2/&r=1 updates-3.4.2]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.4.2/&r=1 updates-3.4.2]
|
+
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.4.2/org.eclipse.egit.repository-3.4.2.201412180340-r.zip 3.4.2.201412180340-r]
 
|-
 
|-
 
| 3.4.1.201406201815-r
 
| 3.4.1.201406201815-r
Line 112: Line 112:
 
| [http://download.eclipse.org/egit/updates-3.4.1 http://download.eclipse.org/egit/updates-3.4.1]
 
| [http://download.eclipse.org/egit/updates-3.4.1 http://download.eclipse.org/egit/updates-3.4.1]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.4.1/&r=1 updates-3.4.1]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.4.1/&r=1 updates-3.4.1]
|
+
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.4.1/org.eclipse.egit.repository-3.4.1.201406201815-r.zip 3.4.1.201406201815-r]
 
|-
 
|-
 
| 3.4.0.201406110918-r
 
| 3.4.0.201406110918-r
Line 118: Line 118:
 
| [http://download.eclipse.org/egit/updates-3.4 http://download.eclipse.org/egit/updates-3.4]
 
| [http://download.eclipse.org/egit/updates-3.4 http://download.eclipse.org/egit/updates-3.4]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.4/&r=1 updates-3.4]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.4/&r=1 updates-3.4]
|
+
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.4/org.eclipse.egit.repository-3.4.0.201406110918-r.zip 3.4.0.201406110918-r]
 
|-
 
|-
 
| 3.3.2.201404171909-r
 
| 3.3.2.201404171909-r
Line 124: Line 124:
 
| [http://download.eclipse.org/egit/updates-3.3.2 http://download.eclipse.org/egit/updates-3.3.2]
 
| [http://download.eclipse.org/egit/updates-3.3.2 http://download.eclipse.org/egit/updates-3.3.2]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.3.2/&r=1 updates-3.3.2]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.3.2/&r=1 updates-3.3.2]
|
+
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.3.2/org.eclipse.egit.repository-3.3.2.201404171909-r.zip 3.3.2.201404171909-r]
 
|-
 
|-
 
| 3.3.1.201403241930-r
 
| 3.3.1.201403241930-r
Line 130: Line 130:
 
| [http://archive.eclipse.org/egit/updates-3.3.1 http://archive.eclipse.org/egit/updates-3.3.1]
 
| [http://archive.eclipse.org/egit/updates-3.3.1 http://archive.eclipse.org/egit/updates-3.3.1]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.3.1/&r=1 updates-3.3.1]
 
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.3.1/&r=1 updates-3.3.1]
|
+
| [http://www.eclipse.org/downloads/download.php?file=/egit/updates-3.3.1/org.eclipse.egit.repository-3.3.1.201403241930-r.zip 3.3.1.201403241930-r]
 
|-
 
|-
 
| 3.3.0.201403021825-r
 
| 3.3.0.201403021825-r

Revision as of 06:48, 26 June 2015

EGit
Website
Download
Community
Mailing ListForumsIRCmattermost
Issues
OpenHelp WantedBug Day
Contribute
Browse SourceProject Set File

What is Git?

Git is a distributed SCM/VCS, which means every developer has a full copy of all history of every revision of the code, making queries against the history very fast and versatile. The EGit project is implementing Eclipse tooling on top of a Java implementation of Git.

What is JGit?

JGit is a EDL/BSD licensed, lightweight, pure Java library implementing the Git version control file access routines, network protocols, and core version control algorithms.

What is EGit?

EGit is an EPL licensed Eclipse Team provider for Git, built on top of JGit.

What is New and Noteworthy?

You can find the latest changes for EGit and JGit below:

Where can I find older releases of EGit?

It's recommended to use the latest released version of EGit, which is always available in this p2 repository (update site): http://download.eclipse.org/egit/updates In case you need an older version, try an older repository, the following table lists the stable URL of all released EGit p2 repositories.

Note: open the p2 repository URL from the Eclipse installation wizard (Help > Install New Software) and add it as a new "Software Site". You may use the p2 browser to inspect the content of a p2 repository.

Release Version Release Date p2 repository URL browse p2 repository download p2 repository
4.0.1.201506240215-r (latest release) 2015-06-24 http://download.eclipse.org/egit/updates-4.0.1 updates-4.0.1 4.0.1.201506240215-r
4.0.0.201506090130-r 2015-06-24 http://download.eclipse.org/egit/updates-4.0 updates-4.0 4.0.0.201506090130-r
3.7.1.201504261725-r 2015-04-26 http://download.eclipse.org/egit/updates-3.7.1 updates-3.7.1 3.7.1.201504261725-r
3.7.0.201502260915-r 2015-02-22 http://download.eclipse.org/egit/updates-3.7 updates-3.7 3.7.0.201502260915-r
3.6.2.201501210735-r 2015-01-21 http://download.eclipse.org/egit/updates-3.6.2 updates-3.6.2 3.6.2.201501210735-r
3.6.1.201501031845-r 2015-01-03 http://download.eclipse.org/egit/updates-3.6.1 updates-3.6.1 3.6.1.201501031845-r
3.6.0.201412230720-r 2014-12-23 http://download.eclipse.org/egit/updates-3.6 updates-3.6 3.6.0.201412230720-r
3.5.3.201412180710-r 2014-12-19 http://download.eclipse.org/egit/updates-3.5.3 updates-3.5.3 3.5.3.201412180710-r
3.5.2.201411120430-r 2014-11-12 http://download.eclipse.org/egit/updates-3.5.2 updates-3.5.2 3.5.2.201411120430-r
3.5.1.201410131835-r 2014-10-14 http://download.eclipse.org/egit/updates-3.5.1 updates-3.5.1 3.5.1.201410131835-r
3.5.0.201409260305-r 2014-09-24 http://download.eclipse.org/egit/updates-3.5 updates-3.5 3.5.0.201409260305-r
3.4.2.201412180340-r 2014-12-19 http://download.eclipse.org/egit/updates-3.4.2 updates-3.4.2 3.4.2.201412180340-r
3.4.1.201406201815-r 2014-06-23 http://download.eclipse.org/egit/updates-3.4.1 updates-3.4.1 3.4.1.201406201815-r
3.4.0.201406110918-r 2014-06-18 http://download.eclipse.org/egit/updates-3.4 updates-3.4 3.4.0.201406110918-r
3.3.2.201404171909-r 2014-04-17 http://download.eclipse.org/egit/updates-3.3.2 updates-3.3.2 3.3.2.201404171909-r
3.3.1.201403241930-r 2014-03-25 http://archive.eclipse.org/egit/updates-3.3.1 updates-3.3.1 3.3.1.201403241930-r
3.3.0.201403021825-r 2014-02-28 http://archive.eclipse.org/egit/updates-3.3 updates-3.3
3.2.0.201312181205-r 2013-12-18 http://archive.eclipse.org/egit/updates-3.2 updates-3.2
3.1.0.201310021548-r 2013-10-02 http://archive.eclipse.org/egit/updates-3.1 updates-3.1
3.0.3.201309161630-r 2013-09-17 http://archive.eclipse.org/egit/updates-3.0.3 updates-3.0.3
3.0.1.201307141637-r 2013-07-15 http://archive.eclipse.org/egit/updates-3.0.1 updates-3.0.1
3.0.0.201306101825-r 2013-06-26 http://archive.eclipse.org/egit/updates-3.0 updates-3.0
2.3.1.201302201838-r 2013-03-01 http://archive.eclipse.org/egit/updates-2.3 updates-2.3
2.2.0.201212191850-r 2012-12-20 http://archive.eclipse.org/egit/updates-2.2 updates-2.2
2.1.0.201209190230-r 2012-09-26 http://archive.eclipse.org/egit/updates-2.1 updates-2.1
2.0.0.201206130900-r 2012-06-27 http://archive.eclipse.org/egit/updates-2.0 updates-2.0
1.3.0.201202151440-r 2012-02-17 http://archive.eclipse.org/egit/updates-1.3 updates-1.3
1.2.0.201112221803-r 2011-12-23 http://archive.eclipse.org/egit/updates-1.2 updates-1.2
1.1.0.201109151100-r 2011-09-22 http://archive.eclipse.org/egit/updates-1.1 updates-1.1
1.0.0.201106090707-r 2011-06-22 http://archive.eclipse.org/egit/updates-1.0 updates-1.0
0.12.1 (Incubation) 2011-05-03 http://archive.eclipse.org/egit/updates-0.12 updates-0.12
0.11.3 (Incubation) 2011-02-21 http://archive.eclipse.org/egit/updates-0.11 updates-0.11
0.10.1 (Incubation) 2010-12-17 http://archive.eclipse.org/egit/updates-0.10 updates-0.10
0.9.3 (Incubation) 2010-09-17 http://archive.eclipse.org/egit/updates-0.9 updates-0.9
0.8.4 (Incubation) 2010-06-14 http://archive.eclipse.org/egit/updates-0.8 updates-0.8


The project follows a pattern of http://download.eclipse.org/egit/updates-<version> for its sites.

Since 3.0 P2 repositories are also deployed to repo.eclipse.org:


Retention Policy

All release p2 repositories will be kept forever.

Latest builds of EGit

Version p2 repository URL browse p2 repository
latest build from master http://download.eclipse.org/egit/updates-nightly updates-nightly
latest build from latest stable branch http://download.eclipse.org/egit/updates-stable-nightly updates-stable-nightly

What versions of Eclipse does EGit target?

In general EGit promises to support at least the latest two Eclipse releases.

If possible we will not prevent usage in older releases but if we want to take advantage of new functionality only available in one of the latest two Eclipse releases but not in older releases we will update dependencies which will in fact discontinue support for older releases.

EGit Contained in release train Supported Version of Eclipse
4.0.1.201506240215-r Eclipse 3.8.2/4.2.2 + (Juno)
4.0.0.201506090130-r Eclipse 4.5.0 (Mars) Eclipse 3.8.2/4.2.2 + (Juno)
3.7.1.201504261725-r Eclipse 3.8.2/4.2.2 + (Juno)
3.7.0.201502260915-r Eclipse 3.8.2/4.2.2 + (Juno)
3.6.2.201501210735-r Eclipse 3.8.2/4.2.2 + (Juno)
3.6.1.201501031845-r Eclipse 3.8.2/4.2.2 + (Juno)
3.6.0.201412230720-r Eclipse 3.8.2/4.2.2 + (Juno)
3.5.3.201412180710-r Eclipse 3.8.2/4.2.2 + (Juno)
3.5.2.201411120430-r Eclipse 3.8.2/4.2.2 + (Juno)
3.5.1.201410131835-r Eclipse 3.8.2/4.2.2 + (Juno)
3.5.0.201409260305-r Eclipse 3.8.2/4.2.2 + (Juno), support for 3.8.2 was fixed see bug 438601
3.4.2.201412180340-r Eclipse 4.4.2 (Luna SR2) Eclipse 4.2.2 + (Juno)
3.4.1.201406201815-r Eclipse 4.4.1 (Luna SR1) Eclipse 4.2.2 + (Juno)
3.4.0.201406110918-r Eclipse 4.4 (Luna) Eclipse 4.2.2 + (Juno)
3.3.1.201403241930-r Eclipse 3.8.2/4.2.2 + (Juno)
3.3.0.201403021825-r Eclipse 3.8.2/4.2.2 + (Juno)
3.2.0.201312181205-r 4.3.2 (Kepler SR2) Eclipse 3.8.2/4.2.2 + (Juno)
3.1.0.201310021548-r Eclipse 3.8.2/4.2.2 + (Juno)
3.0.3.201309161630-r 4.3.1 (Kepler SR1) Eclipse 3.8.2/4.2.2 + (Juno)
3.0.1.201307141637-r 4.3.0 (Kepler) Eclipse 3.8.2/4.2.2 + (Juno)
2.3.1.201302201838-r 3.8.2/4.2.2 (Juno SR2) Eclipse 3.7.2+ (Indigo) (except EGit Import Support feature, which is optional)
2.2.0.201212191850-r 3.8.1/4.2.1 (Juno SR1) Eclipse 3.7.2+ (Indigo) (except EGit Import Support feature, which is optional)
2.1.0.201209190230-r 3.8.1/4.2.1 (Juno SR1) Eclipse 3.5.2+ (Galileo) (except EGit Import Support feature, which is optional)
2.0.0.201206130900-r 3.8/4.2 (Juno) Eclipse 3.5.2+ (Galileo) (except EGit Import Support feature, which is optional)
1.3.0.201202151440-r 3.7.2 (Indigo SR2) Eclipse 3.5.2+ (Galileo)
1.2.0.201112221803-r 3.7.2 (Indigo SR2) Eclipse 3.5.2+ (Galileo)
1.1.0.201109151100-r 3.7.1 (Indigo SR1) Eclipse 3.5.2+ (Galileo)
1.0.0.201106090707-r 3.7.0 (Indigo) Eclipse 3.5.2+ (Galileo)


Compatible version of Git:
Compatibility is on a feature by feature basis. Currently the major version related difference is in how Git handles file names with non-ASCII file names. Git for Windows 1.7.10 and later encodes filenames in UTF-8 which is compatible with JGit. Git on Mac, v1.7.12 can encode filenames in a way that is compatible with EGit and Git for Windows if core.precomposeunicode is set to true. However EGit on OS X does not handle Unicode well.

What are the main differences between original Git and JGit(EGit)?

See this page Differences to Git

What is the mapping Git commands to EGit operations?

See this page Mapping Git Commands

How compatible is EGit with Git?

Some, but not all configuration options/features in Git are available in EGit/JGit. Here is a summary, not yet complete describing some of these, including notable differences. Note that the set of EGit/JGit is not based off a particular Git version.

config

config description
branch.autosetuprebase supported
branch.autosetupmerge supported
core.autocrlf Since 2.0 supports true,false and input. See the tutorial for notes about making sure EGit picks up the configuration. Complementary core.safecrlf and gitattributes are not supported yet.
core.bare supported
core.checkstat supported (2.3)
core.compression zlib compression level
core.excludesfile Contains ignore rules, in addition to .gitignore
core.filemode supported
core.ignorecase not supported
core.logallrefupdates supported
core.packindexversion version 1 and 2 supported
core.precomposeunicode Ignore. See Bug 413390
core.repositoryformatversion recognized, only "0" supported
core.safecrlf not supported
core.worktree supported in JGit, not EGit
diff.algorithm myers, histogram (default: histogram)
pack.indexVersion Default 2,-1 for older format
user.email supported
user.name supported

Supported in JGit, but no EGit usually amounts to having no or strange behavior would one attempt to use it in the Eclipse IDE.

Notes: For those that can read the source, look at ConfigConstants.java for a hint on what options JGit recognizes. If it appears there, an option may be supported, but it may also mean for a few cases that JGit just looks for it and then explicitly tells the user the option is not supported. If it does not appear, it's most certainly up for grabs as a contribution. The file contains lots of config options that only applies to JGit (DFS, gerrit).

Environment

JGit supports some environment variables. Do not set those for the Eclipse IDE. We'll list a few ones that may be used, but most apply only to using JGit from the command line.

variable description
GIT_ALTERNATE_OBJECT_DIRECTORIES supported
GIT_AUTHOR_EMAIL supported
GIT_AUTHOR_NAME supported
GIT_CEILING_DIRECTORIES supported. Also EGit may be benefited when used with automounted file systems
GIT_DIR supported
GIT_INDEX_FILE supported
GIT_OBJECT_DIRECTORY supported
GIT_SSH plink, tortoiseplink

SSH config

TBD: JGit does its own parsing of the ~/.ssh/config file.

Using PuTTY Agent on Windows for SSH Keys

It is possible to use PuTTY's key management capabilities on Windows for EGit as well. For that you work you must install PuTTY and TortoiseGit. Then set GIT_SSH environment variable to c:\Programe Files\TortoiseGit\bin\TortoisePlink.exe.

Store SSH Key Passphrase in Mac Keyring

It is possible to store the SSH Key Passphrase in Mac's Keyring. However. EGit's internal SSH client does not support this. Thus, in order benefit from Keyring EGit must be configured to use the Mac vanilla SSH agent. This is possible by setting the GIT_SSH environment variable to /usr/bin/ssh.

 export GIT_SSH=/usr/bin/ssh

For OSX Mavericks, see this Stackoverflow question for how to set environment variable for applications like Eclipse.

Back to the top