diff options
author | Manos Pitsidianakis <el13635@mail.ntua.gr> | 2019-09-22 22:51:34 +0300 |
---|---|---|
committer | Manos Pitsidianakis <el13635@mail.ntua.gr> | 2019-09-22 22:51:34 +0300 |
commit | ed248be03179f0d188d0fff7f7fc7ea5647262e4 (patch) | |
tree | eb0a2c76e85484db88fbe6e88b47b1eb6917554a | |
parent | 415fb2455b1c1a46439a61db6494956a08f48b6f (diff) |
Restore accidentally removed README
-rw-r--r-- | README | 55 |
1 files changed, 50 insertions, 5 deletions
@@ -1,3 +1,49 @@ + __ + __/ \__ +/ \__/ \__ . +\__/ \__/ \ , _ , _ ___ │ ' +/ \__ \__/ │' `│ `┒ .' ` │ │ +\__/ \__/ \ │ │ │ |────' │ │ + \__/ \__/ │ / `.___, /\__ / + \__/ + ,-. + \_/ + terminal mail user agent {|||)< + / \ + `-' +DOCUMENTATION +============= + +After installing meli, see meli(1) and meli.conf(5) for documentation. + +BUILDING +======== + +meli requires rust 1.34 and rust's package manager, Cargo. Information on how +to get it on your system can be found here: + +https://doc.rust-lang.org/cargo/getting-started/installation.html + +With Cargo available, the project can be built with + +# make + +The resulting binary will then be found under target/release/meli + +Run: + +# make install + +to install the binary and man pages. This requires root, so I suggest you override the default paths and install it in your $HOME: + +# make PREFIX=$HOME/.local install + +See meli(1) and meli.conf(5) for documentation. + +You can build and run meli with one command: + +# cargo run --release + While the project is in early development, meli will only be developed for the linux kernel and respected linux distributions. Support for more UNIX-like OSes is on the roadmap. @@ -8,11 +54,10 @@ DEVELOPMENT Development builds can be built and/or run with # cargo build -# cargo run +# cargo run 2> debug.log -There is a debug/tracing log feature that can be enabled by using the flag -`--feature debug-tracing` or in a development profile in Cargo.toml. The logs -are printed in stderr, thus you can run meli with a redirection (i.e `2> log`) +The debug logs can be disabled by setting debug-assertions to false in the +development profile in Cargo.toml. In the future debug logs will be a feature. CONFIG ====== @@ -23,7 +68,7 @@ meli by default looks for a configuration file in this location: You can run meli with arbitrary configuration files by setting the MELI_CONFIG environment variable to their locations, ie: -# MELI_CONFIG=./test_config cargo run +# MELI_CONFIG=./test_config cargo run 2> debug.log TESTING ======= |