aboutsummaryrefslogtreecommitdiffstats
path: root/INSTALL.md
diff options
context:
space:
mode:
authorAdam Spiers <git@adamspiers.org>2018-05-16 18:26:42 +0100
committerAdam Spiers <git@adamspiers.org>2018-05-16 18:26:42 +0100
commitde8c075dbcdffbe63a239c764509ee1a1e9d28d0 (patch)
tree4b715fb886bdb92fbddcd214b6e954153c749404 /INSTALL.md
parent98f8f911b505607458aa01fb67f32a32420fcc92 (diff)
downloadgit-deps-de8c075dbcdffbe63a239c764509ee1a1e9d28d0.tar.gz
add more clarity to installation instructions
Diffstat (limited to 'INSTALL.md')
-rw-r--r--INSTALL.md27
1 files changed, 17 insertions, 10 deletions
diff --git a/INSTALL.md b/INSTALL.md
index 7c75b76..8e7c239 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -13,6 +13,8 @@ together](http://www.pygit2.org/install.html#version-numbers).
## Option 1: Install pygit2 and libgit2 from OS packages, and `git-deps` as a Python module
+### Install OS packages
+
if you are using Linux, there is a good chance that your distribution
already offers packages for both pygit2 and libgit2, in which case
installing pygit2 from packages should also automatically install
@@ -28,9 +30,16 @@ pygit2's website also has installation instructions for
[Windows](http://www.pygit2.org/install.html#installing-on-windows)
and [Mac OS](http://www.pygit2.org/install.html#installing-on-os-x).
-Finally, install `git-deps` via `pip`:
+### Install `git-deps` via `pip`
+
+Finally, install `git-deps` via `pip`, for example system-wide on
+Linux via:
+
+ sudo pip install git-deps
- pip install git-deps
+or just for the current user:
+
+ pip install --user git-deps
## Option 2: Install libgit2 from OS packages, and `git-deps` / pygit2 as Python modules
@@ -39,14 +48,12 @@ distribution's packaging tool, e.g. on openSUSE:
sudo zypper install libgit2-24
-Then install `git-deps` which should also automatically install pygit2
-as one of its dependencies:
-
- pip install git-deps
-
-However be aware that this will pick a pygit2 version based on
-`requirements.txt` from `git-deps`, which may not be compatible with
-the libgit2 you have installed from OS packages.
+Then install `git-deps` via `pip` as described in option 1 above.
+This should also automatically install pygit2 as one of its
+dependencies. However be aware that this will pick a pygit2 version
+based on [`requirements.txt`](requirements.txt) from `git-deps`, which
+may not be compatible with the libgit2 you have installed from OS
+packages. Suggestions for workaround to this are welcome!
## Option 3: Install everything from source