aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJwanMan <public@mn.900k.es>2017-02-26 17:48:22 +0000
committerGitHub <noreply@github.com>2017-02-26 17:48:22 +0000
commit1a304d5f288d76f548f584b093428b15a02f5072 (patch)
treec389c9219827c9da0aa3275e1a4468aaab52d8d6
parente23a6a90e41d9834b37d924db2c64798db2a4de6 (diff)
Upload the actual program.
-rw-r--r--README.md24
1 files changed, 24 insertions, 0 deletions
diff --git a/README.md b/README.md
index 5d4f067..9fb00d5 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,26 @@
# use-manager
A really simple script/use-case manager.
+
+This is a tiny, public domain, shell program to manage your scripts and use cases (an use case is a script used to open anything you need to perform a task). The scripts you manage with this program should have a sha-bang (#!) line, as this utility is meant to be independent from the programming language.
+
+Installation
+-----------
+
+This program runs on every UNIX-like operating system (such as Linux) that has the Bourne-Again Shell (bash) installed.
+
+To install it, clone this repo, copy the `use` file somewhere on your path and, if you want to access from the desktop, copy the `use.desktop` file to `/usr/share/applications`. In other words:
+```
+cd `mktemp -d`
+git clone https://github.com/JwanMan/use-manager.git
+cd use-manager
+mv use /usr/local/bin/
+mv use.desktop /usr/share/applications/
+```
+
+Configuration
+------------
+
+The program behaviour can be modified by the following environment variables:
+* `USE_DIR`: The directory where the scripts are stored. By default, it's `~/.userc`.
+* `EDITOR`: The program to be used to edit the scripts, plus any additional parameters. By default, it's `nano`.
+* `SHOW`: The program to show the scripts. By default, it's `less`.