]> git.armaanb.net Git - gen-shell.git/blobdiff - README.md
Major restructuring
[gen-shell.git] / README.md
index ead6bf44bdc06f7e3a6b9c23697455d85725c73c..5b0e8356c34e5000384987693a1cd20d433bc4f2 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,20 +1,20 @@
 # gen-shell
-![Jenkins](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fbuild.bhojwani.org%2Fjob%2Fgen-shell%2F) 
-A work in progress generic shell forked form [taskshell](https://github.com/GothenburgBitFactory/taskshell)
+A simple way to turn any command into a REPL with arrow key/history support.
 
-## Installation
-Binaries can be downloaded [from here](https://build.bhojwani.org/job/gen-shell/lastSuccessfulBuild/artifact/build/src/gen-shell). Note that these binaries are compiled against libreadline7, so if your system only has libreadline8, you should symlink 8 to 7 with `sudo ln -s /usr/lib/x86_64-linux-gnu/libreadline.so.8.0 /usr/lib/x86_64-linux-gnu/libreadline.so.7`. This isn't a great solution, but it gets the job done.
+## Usage
+See `gen-shell --help`
 
-If you would like to avoid this, you can build from source. Doing so requires:
-  - CMake
-  - g++
-  - libreadline development files
+## Installation
+Dependencies:  
+  - POSIX make
+  - a c++ compiler and standard library
+  - libreadline development files (7 or 8 is fine, 5 is untested)
 
+```bash
+make
+make install
 ```
-git clone https://codeberg.org/armaan/gen-shell
-cd gen-shell
-cmake --build .
-sudo cp src/gen-shell /usr/bin/
-```
-Or if you don't have root access, you can subsitute the last line with
-`cp src/gen-shell ~/.local/bin`
+## License
+Following suit from taskshell, gen-shell is MIT licensed by Armaan Bhojwani, 2021. Gen-shell is forked from taskshell, which was developed by [these people](https://github.com/GothenburgBitFactory/taskshell/blob/master/AUTHORS).
+
+Gen-shell uses the [Sarge library](https://github.com/MayaPosch/Sarge) for parsing command-line arguments. Sarge was written by Maya Posch and is BSD 3-Clause licensed.