summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorRobin Stocker <robin@nibor.org>2012-09-08 19:58:37 +0200
committerRobin Stocker <robin@nibor.org>2012-09-08 19:58:37 +0200
commit6b74aff641dd5366a7c13315f25b5f85816fe17e (patch)
tree96ae5be1dcb7171da2bc1bd015402ba5ff071cc8 /README
parente63f1c94f8f9a5b10da6c1e5932da33eb805230a (diff)
downloadjgit-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--README136
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/
-