aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md40
1 files changed, 40 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bfa97fb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+<!-- vi: tw=80
+ -->
+# `liblux`
+
+## Overview
+
+`liblux` is a minimal C library (C++ compatible) for interacting with screen
+brightness levels on Linux systems. The library offers a simple to use and well
+documented API for getting and setting screen brightness using both raw values
+and percentages.
+
+## Compilation
+
+Compilation of the library is extremely simple:
+
+```
+$ make # To build the library
+# make install # To install the library, requires root privileges
+```
+
+After compilation and installation, you will be able to build programs using the
+`liblux` library that are dynamically or statically linked.
+
+## Documentation
+
+All library functions are documented via manual pages. After installing the
+library using the above commands, the manual pages will be installed on your
+system and you’ll be able to read the documentation using the `man` command as
+such:
+
+```
+$ man luxget # To view documentation for the luxget(3) function
+```
+
+If you prefer to view documentation in your browser (why?), all manuals are also
+available over at [my website][1]. [Here][2] is the link to view documentation
+for the `luxinit(3)` function, for example.
+
+[1]: https://thomasvoss.com/man
+[2]: https://thomasvoss.com/man/luxinit.3.html