diff options
author | Edward Thomson <ethomson@edwardthomson.com> | 2021-01-07 15:08:37 +0000 |
---|---|---|
committer | Edward Thomson <ethomson@edwardthomson.com> | 2021-01-07 15:08:37 +0000 |
commit | 4ac12634195e225893fd458c0aab3fc5a9bdaae5 (patch) | |
tree | e158e30a6025495a827534b4c22ed3d8d1f9e62c | |
parent | c31032a3cf449b77c1ca2a966ec3ca31f2f1fb00 (diff) | |
download | libgit2-ethomson/readme.tar.gz |
README: instructions for using libgit2 without compilingethomson/readme
-rw-r--r-- | README.md | 23 |
1 files changed, 23 insertions, 0 deletions
@@ -33,6 +33,7 @@ Additionally, the example code has been released to the public domain (see the Table of Contents ================= +* [Using libgit2](#using-libgit2) * [Quick Start](#quick-start) * [Getting Help](#getting-help) * [What It Can Do](#what-it-can-do) @@ -52,6 +53,28 @@ Table of Contents * [How Can I Contribute?](#how-can-i-contribute) * [License](#license) +Using libgit2 +============= + +Most of these instructions assume that you're writing an application +in C and want to use libgit2 directly. If you're _not_ using C, +and you're writing in a different language or platform like .NET, +Node.js, or Ruby, then there is probably a +"[language binding](#language-bindings)" that you can use to take care +of the messy tasks of calling into native code. + +But if you _do_ want to use libgit2 directly - because you're building +an application in C - then you may be able use an existing binary. +There are packages for the +[vcpkg](https://github.com/Microsoft/vcpkg) and +[conan](https://conan.io/center/libgit2) +package managers. And libgit2 is available in +[Homebrew](https://formulae.brew.sh/formula/libgit2) and most Linux +distributions. + +However, these versions _may_ be outdated and we recommend using the +latest version if possible. Thankfully libgit2 is not hard to compile. + Quick Start =========== |