From fca1d101dde4a98ee9b95214918586076a7708dc Mon Sep 17 00:00:00 2001 From: Thomas Voss Date: Sat, 27 Aug 2022 22:38:12 +0200 Subject: Add a README --- README.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..bfa97fb --- /dev/null +++ b/README.md @@ -0,0 +1,40 @@ + +# `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 -- cgit v1.2.3