From 8ab603f8d631278c14a93ef28144e988692fd711 Mon Sep 17 00:00:00 2001 From: NPScript Date: Sun, 26 Sep 2021 17:32:36 +0200 Subject: first commit --- README.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..e2f4bfc --- /dev/null +++ b/README.md @@ -0,0 +1,54 @@ +# SCRUBS - Let's Prepare The Operation + +Scrubs is a little documentation tool written in POSIX-Shell. It should make easier to work in teams in a suckless way. + +## Features + +There are two kinds of tags which are displayed in scrubs, `DOC` and `TODO`. + +`DOC` is used to document your functions or classes. It has the following structur: + +``` c++ +/** DOC + * @type function + * @name some_random_function + * + * @param input * data + * the input data for processing + * + * @return output + * + * @description + * Here you have the function description. + * It is allowed to have multiple lines. + * Isn't that cool? + */ +``` + +The `TODO` tag has the following structur: + +``` c++ +/** TODO + * @category some_bug + * + * @description + * Some weared bug lol + * what is this??? + */ +``` + +*For more examples see `example.cpp`* + +## Install + +There is a *Makefile* so you are able to install `scrubs` with: + +``` bash +sudo make install +``` + +To uninstall + +``` bash +sudo make uninstall +``` -- cgit v1.2.3-70-g09d2