aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorNicolas Dato <nicolas.dato@gmail.com>2025-08-07 20:34:54 -0300
committerNicolas Dato <nicolas.dato@gmail.com>2025-08-07 20:34:54 -0300
commit044a46bb3b86ee5dcd368929d5da2f4f44806e04 (patch)
tree40adb93ee0aba036a90790e177f77ad756b14664 /README.md
parentcef8f4c5062a5d509d9bc247869431e5dec5ced3 (diff)
downloadlibtuberia-044a46bb3b86ee5dcd368929d5da2f4f44806e04.tar.gz
improving documentation
Diffstat (limited to 'README.md')
-rw-r--r--README.md22
1 files changed, 16 insertions, 6 deletions
diff --git a/README.md b/README.md
index 22079b8..11ebbd4 100644
--- a/README.md
+++ b/README.md
@@ -24,17 +24,19 @@ SOFTWARE.
## About
-libtuberia: a library to implement a pipeline
+libtuberia: a library to implement a pipeline.
A pipeline would be:
*[Source] -> [queue_1] -> [Stage_1] -> [Queue_2] -> [Stage_2] -> [...] -> [Sink]*
-Each source, stage, and sink runs in a thread, reads from its imput queue and
-write to the output queue
+Each source, stage, and sink runs in a thread, reads from its input queue,
+process the element, and writes the result to the output queue.
-You can omit the source and sink, and inject or retrieve elements from the
-pipeline
+This project is available:
+* At my personal website: <https://ndato.com/projects/libtuberia/>
+* At Savannah: <https://savannah.nongnu.org/projects/libtuberia/>
+You can submit bugs at Savannah.
## Building, Compiling, Installing
@@ -58,7 +60,15 @@ Include tuberia.h, and link libtuberia.a and pthread: `-ltuberia -lpthread`
You can also use: `pkg-config --cflags --libs --static tuberia`
-## Quick Guide
+## Documentation
+
+The `src/tuberia.h` file has every structure and function documented.
+
+And if you had [Doxygen](https://www.doxygen.nl) when installing libtuberia, a
+man page `tuberia.h` is also installed (you can read it with `man tuberia.h`)
+and a .html is installed in `/usr/doc/libtuberia/doxygen_html/index.html`.
+
+### Quick Guide
See the files `example/simple.c` and `example/decode_resize_encode.c`
(function `do_tuberia()` in particular)