From 2cd3a82b73ca8f487e452a66a150605d5a348d50 Mon Sep 17 00:00:00 2001 From: jutty Date: Mon, 8 Jul 2024 07:52:51 -0300 Subject: [PATCH] Add installation and usage instructions to README --- README.md | 28 ++++++++++++++++++++++++++++ src/tori => tori | 0 2 files changed, 28 insertions(+) rename src/tori => tori (100%) diff --git a/README.md b/README.md index 8fb3e98..db92a08 100644 --- a/README.md +++ b/README.md @@ -7,3 +7,31 @@ If you'd like a more detailed description of what it is, its purpose, origins an You can find documentation in the [docs](docs) directory: - [Usage documentation](docs/usage) - [Development documentation](docs/development) + +## Installation + +As it is still in very early development, tori is not yet packaged. + +If you want to try it, you can clone this repository to your system and create the configuration file at `~/.config/tori/tori.conf` containing the following setting: + +```conf +tori_root = /path/to/repository +``` + +If you clone it to the default location, `~/.local/share/tori`, the above step is not necessary. + +Finally, you need to symlink the `tori` file at the repository root to somewhere on your `$PATH`: + +``` +ln -s /path/to/repository/tori $HOME/.local/bin/tori +``` + +## Usage + +Currently, the following options are implemented: + +- `check`: check for divergences between the configuration and the system +- `help`: show a usage summary with supported options +- `version`: print the current version and its release date + +To issue a command, use `tori `, as in `tori check`. diff --git a/src/tori b/tori similarity index 100% rename from src/tori rename to tori