Update the README with current modules and features
Change-Id: Ic30f55f30ce260dc02c428e1ebf11f01cb790a6e Signed-off-by: Matthias Sohn <matthias.sohn@sap.com>
This commit is contained in:
parent
05896dabfc
commit
2475d95374
90
README.md
90
README.md
|
@ -6,19 +6,39 @@ An implementation of the Git version control system in pure Java.
|
||||||
This package is licensed under the EDL (Eclipse Distribution
|
This package is licensed under the EDL (Eclipse Distribution
|
||||||
License).
|
License).
|
||||||
|
|
||||||
|
JGit can be imported straight into Eclipse, built and tested from
|
||||||
|
there, but the automated builds use Maven.
|
||||||
|
|
||||||
- org.eclipse.jgit
|
- org.eclipse.jgit
|
||||||
|
|
||||||
A pure Java library capable of being run standalone, with no
|
A pure Java library capable of being run standalone, with no
|
||||||
additional support libraries. It provides classes to read and
|
additional support libraries. It provides classes to read and
|
||||||
write a Git repository and operate on a working directory.
|
write a Git repository and operate on a working directory.
|
||||||
|
|
||||||
All portions of jgit are covered by the EDL. Absolutely no GPL,
|
All portions of JGit are covered by the EDL. Absolutely no GPL,
|
||||||
LGPL or EPL contributions are accepted within this package.
|
LGPL or EPL contributions are accepted within this package.
|
||||||
|
|
||||||
|
- org.eclipse.jgit.java7
|
||||||
|
|
||||||
|
Extensions for users of Java 7.
|
||||||
|
|
||||||
- org.eclipse.jgit.ant
|
- org.eclipse.jgit.ant
|
||||||
|
|
||||||
Ant tasks based on JGit.
|
Ant tasks based on JGit.
|
||||||
|
|
||||||
|
- org.eclipse.jgit.archive
|
||||||
|
|
||||||
|
Support for exporting to various archive formats (zip etc).
|
||||||
|
|
||||||
|
- org.eclipse.jgit.console
|
||||||
|
|
||||||
|
Support for reading passwords from the console without
|
||||||
|
echoing them. Requires Java 6.
|
||||||
|
|
||||||
|
- org.eclipse.jgit.http.apache
|
||||||
|
|
||||||
|
Apache httpclient support
|
||||||
|
|
||||||
- org.eclipse.jgit.http.server
|
- org.eclipse.jgit.http.server
|
||||||
|
|
||||||
Server for the smart and dumb Git HTTP protocol.
|
Server for the smart and dumb Git HTTP protocol.
|
||||||
|
@ -28,19 +48,44 @@ License).
|
||||||
Command-line interface Git commands implemented using JGit
|
Command-line interface Git commands implemented using JGit
|
||||||
("pgm" stands for program).
|
("pgm" stands for program).
|
||||||
|
|
||||||
|
- org.eclipse.jgit.packaging
|
||||||
|
|
||||||
|
Production of Eclipse features and p2 repository for JGit. See the JGit
|
||||||
|
Wiki on why and how to use this module.
|
||||||
|
|
||||||
|
Tests
|
||||||
|
-----
|
||||||
|
|
||||||
|
- org.eclipse.jgit.junit
|
||||||
|
|
||||||
|
Helpers for unit testing
|
||||||
|
|
||||||
- org.eclipse.jgit.test
|
- org.eclipse.jgit.test
|
||||||
|
|
||||||
Unit tests for org.eclipse.jgit and the same licensing rules.
|
Unit tests for org.eclipse.jgit
|
||||||
|
|
||||||
|
- org.eclipse.jgit.java7.test
|
||||||
|
|
||||||
|
Unit tests for Java 7 specific features
|
||||||
|
|
||||||
|
- org.eclipse.jgit.ant.test
|
||||||
|
- org.eclipse.jgit.pgm.test
|
||||||
|
- org.eclipse.jgit.http.test
|
||||||
|
- org.eclipse.jgit.junit.test
|
||||||
|
|
||||||
|
No further description needed
|
||||||
|
|
||||||
Warnings/Caveats
|
Warnings/Caveats
|
||||||
----------------
|
----------------
|
||||||
|
|
||||||
- Symbolic links are not supported because java does not support it.
|
- Native smbolic links are supported, but only if you are using Java 7
|
||||||
Such links could be damaged.
|
or newer and include the org.eclipse.jgit.java7 jar/bundle in the
|
||||||
|
classpath, provided the file system supports them. For Windows you
|
||||||
|
must have Windows Vista/Windows 2008 or newer, use a
|
||||||
|
non-administrator account and have the SeCreateSymbolicLinkPrivilege.
|
||||||
|
|
||||||
- Only the timestamp of the index is used by jgit check if the index
|
- Only the timestamp of the index is used by jgit if the index is
|
||||||
is dirty.
|
dirty.
|
||||||
|
|
||||||
- Don't try the library with a JDK other than 1.6 (Java 6) unless you
|
- Don't try the library with a JDK other than 1.6 (Java 6) unless you
|
||||||
are prepared to investigate problems yourself. JDK 1.5.0_11 and later
|
are prepared to investigate problems yourself. JDK 1.5.0_11 and later
|
||||||
|
@ -59,12 +104,12 @@ Warnings/Caveats
|
||||||
Git is installed. Make sure Git can be found via the PATH
|
Git is installed. Make sure Git can be found via the PATH
|
||||||
environment variable. When installing Git for Windows check the "Run
|
environment variable. When installing Git for Windows check the "Run
|
||||||
Git from the Windows Command Prompt" option. There are other options
|
Git from the Windows Command Prompt" option. There are other options
|
||||||
like the jgit.gitprefix system propety or Eclipse settings that can
|
like the jgit.gitprefix system property or Eclipse settings that can
|
||||||
be used for pointing out where C Git is installed. Modifying PATH is
|
be used for pointing out where C Git is installed. Modifying PATH is
|
||||||
the recommended option if C Git is installed.
|
the recommended option if C Git is installed.
|
||||||
|
|
||||||
- We try to use the same notation of $HOME as C Git does. On Windows
|
- We try to use the same notation of $HOME as C Git does. On Windows
|
||||||
this is often not same value as the user.home system property.
|
this is often not the same value as the user.home system property.
|
||||||
|
|
||||||
|
|
||||||
Package Features
|
Package Features
|
||||||
|
@ -105,11 +150,40 @@ Package Features
|
||||||
Push via ssh, git and Amazon S3. JGit does not yet deltify
|
Push via ssh, git and Amazon S3. JGit does not yet deltify
|
||||||
the pushed packs so they may be a lot larger than C Git packs.
|
the pushed packs so they may be a lot larger than C Git packs.
|
||||||
|
|
||||||
|
* Garbage collection
|
||||||
|
|
||||||
|
* Merge
|
||||||
|
|
||||||
|
* Rebase
|
||||||
|
|
||||||
|
* And much more
|
||||||
|
|
||||||
- org.eclipse.jgit.pgm/
|
- org.eclipse.jgit.pgm/
|
||||||
|
|
||||||
* Assorted set of command line utilities. Mostly for ad-hoc testing of jgit
|
* Assorted set of command line utilities. Mostly for ad-hoc testing of jgit
|
||||||
log, glog, fetch etc.
|
log, glog, fetch etc.
|
||||||
|
|
||||||
|
- org.eclipse.jgit.java7/
|
||||||
|
|
||||||
|
* Support for symbolic links.
|
||||||
|
|
||||||
|
* Optimizations for reading file system attributes
|
||||||
|
|
||||||
|
- org.eclipse.jgit.ant/
|
||||||
|
|
||||||
|
* Ant tasks
|
||||||
|
|
||||||
|
- org.eclipse.jgit.archive/
|
||||||
|
|
||||||
|
* Support for Zip/Tar and other formats
|
||||||
|
|
||||||
|
- org.eclipse.jgit.console/
|
||||||
|
|
||||||
|
* Reads passwords from the console
|
||||||
|
|
||||||
|
- org.eclipse.http.*/
|
||||||
|
|
||||||
|
* HTTP client and server support
|
||||||
|
|
||||||
Missing Features
|
Missing Features
|
||||||
----------------
|
----------------
|
||||||
|
|
Loading…
Reference in New Issue