diff options
author | Robin Stocker <robin@nibor.org> | 2012-09-08 19:58:37 +0200 |
---|---|---|
committer | Robin Stocker <robin@nibor.org> | 2012-09-08 19:58:37 +0200 |
commit | 6b74aff641dd5366a7c13315f25b5f85816fe17e (patch) | |
tree | 96ae5be1dcb7171da2bc1bd015402ba5ff071cc8 /README | |
parent | e63f1c94f8f9a5b10da6c1e5932da33eb805230a (diff) | |
download | jgit-6b74aff641dd5366a7c13315f25b5f85816fe17e.tar.gz jgit-6b74aff641dd5366a7c13315f25b5f85816fe17e.zip |
README: Convert to Markdown and rename to README.md
This makes it display nicely on the GitHub mirror repository. And it is
still very pleasant to read in plain text.
Change-Id: I0c5e1caa58a22684cdbd9a02e9ec38e97d5adb1a
Signed-off-by: Robin Stocker <robin@nibor.org>
Diffstat (limited to 'README')
-rw-r--r-- | README | 136 |
1 files changed, 0 insertions, 136 deletions
diff --git a/README b/README deleted file mode 100644 index 03b08b002f..0000000000 --- a/README +++ /dev/null @@ -1,136 +0,0 @@ - == Java GIT == - -This package is licensed under the EDL (Eclipse Distribution -License). - - org.eclipse.jgit/ - - A pure Java library capable of being run standalone, with no - additional support libraries. Some JUnit tests are provided - to exercise the library. The library provides functions to - read and write a GIT formatted repository. - - All portions of jgit are covered by the EDL. Absolutely no GPL, - LGPL or EPL contributions are accepted within this package. - - org.eclipse.jgit.test/ - Unit tests for org.eclipse.jgit and the same licensing rules. - - == WARNINGS / CAVEATS == - -- Symbolic links are not supported because java does not support it. - Such links could be damaged. - -- Only the timestamp of the index is used by jgit check if the index - is dirty. - -- 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 - Java 5 versions *may* work. Earlier versions do not. JDK 1.4 is *not* - supported. Apple's Java 1.5.0_07 is reported to work acceptably. We - have no information about other vendors. Please report your findings - if you try. - -- CRLF conversion is performed depending on the core.autocrlf setting, - however Git for Windows by default stores that setting during - installation in the "system wide" configuration file. If Git is not - installed, use the global or repository configuration for the - core.autocrlf setting. - -- The system wide configuration file is located relative to where C - Git is installed. Make sure Git can be found via the PATH - environment variable. When installing Git for Windows check the "Run - Git from the Windows Command Prompt" option. There are other options - like the jgit.gitprefix system propety or Eclipse settings that can - be used for pointing out where C Git is installed. Modifying PATH is - the recommended option if C Git is installed. - -- 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. - - == Package Features == - - org.eclipse.jgit/ - - * Read loose and packed commits, trees, blobs, including - deltafied objects. - - * Read objects from shared repositories - - * Write loose commits, trees, blobs. - - * Write blobs from local files or Java InputStreams. - - * Read blobs as Java InputStreams. - - * Copy trees to local directory, or local directory to a tree. - - * Lazily loads objects as necessary. - - * Read and write .git/config files. - - * Create a new repository. - - * Read and write refs, including walking through symrefs. - - * Read, update and write the Git index. - - * Checkout in dirty working directory if trivial. - - * Walk the history from a given set of commits looking for commits - introducing changes in files under a specified path. - - * Object transport - Fetch via ssh, git, http, Amazon S3 and bundles. - 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. - - org.eclipse.jgit.pgm/ - - * Assorted set of command line utilities. Mostly for ad-hoc testing of jgit - log, glog, fetch etc. - - == Missing Features == - -There are a lot of missing features. You need the real Git for this. -For some operations it may just be the preferred solution also. There -are not just a command line, there is e.g. git-gui that makes committing -partial files simple. - -- Merging. - -- Repacking. - -- Generate a GIT format patch. - -- Apply a GIT format patch. - -- Documentation. :-) - -- gitattributes support - In particular CRLF conversion is not implemented. Files are treated - as byte sequences. - -- submodule support - Submodules are not supported or even recognized. - - == Support == - - Post question, comments or patches to the git@vger.kernel.org mailing list. - - - == Contributing == - - See SUBMITTING_PATCHES in this directory. However, feedback and bug reports - are also contributions. - - - == About GIT == - -More information about GIT, its repository format, and the canonical -C based implementation can be obtained from the GIT websites: - - http://git.or.cz/ - http://www.kernel.org/pub/software/scm/git/ - http://www.kernel.org/pub/software/scm/git/docs/ - |