From f3da2cfee5469c7db87211c45a535f47456d9425 Mon Sep 17 00:00:00 2001 From: Justus Winter Date: Tue, 13 Mar 2018 15:45:50 +0100 Subject: Add some metadata and a README with build instructions. --- Cargo.toml | 6 ++++++ README.md | 31 +++++++++++++++++++++++++++++++ 2 files changed, 37 insertions(+) create mode 100644 README.md diff --git a/Cargo.toml b/Cargo.toml index 1aacaccc..1d9e7b6f 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -2,6 +2,12 @@ name = "sequoia" version = "0.1.0" authors = ["Neal H. Walfield "] +documentation = "https://docs.sequoia-pgp.org/" +homepage = "https://sequoia-pgp.org/" +repository = "https://gitlab.com/sequoia-pgp/sequoia" +readme = "README.md" +publish = false # not yet... + [workspace] diff --git a/README.md b/README.md new file mode 100644 index 00000000..58b29362 --- /dev/null +++ b/README.md @@ -0,0 +1,31 @@ +Sequoia PGP +=========== + +Sequoia is a cool new OpenPGP implementation. It consists of several +crates, providing both a low-level and a high-level API for dealing +with OpenPGP data. + +Building Sequoia +================ + +If you want to use Sequoia from Rust, you can simply register the +dependency in your `Cargo.toml` file as with any other project. Note +that we depend on a number of C libraries, which must be present along +with their development packages. + +To build Sequoia, you need a Rust toolchain and a few libraries. To +install those on a Debian system, do: + + # apt install git rustc cargo clang make pkg-config nettle-dev libssl-dev capnproto libsqlite3-dev + +Furthermore, we also provide a C API, and bindings to other languages. +We also consider the needs of packagers in times where distribution +support for packaging Rust projects is not yet mature enough to handle +a project like Sequoia. Therefore, we provide a `Makefile` to +simplify building, testing, and installing Sequoia. + +To build Sequoia, simply execute `make`. To run the test suites, +execute `make test` (or use the `check` alias). To install Sequoia, +use `make install`. The latter target honors `PREFIX` and `DESTDIR`. +Finally, to return your source tree to its pristine state, run `make +clean`. -- cgit v1.2.3