Cleanup README.adoc (#7)

* Cleanup README.adoc

* Fix issues in README.adoc

Set kiwmi to lowercase.
Remove unintended heading.
Change "barely anything" to "almost nothing" for clarity.
This commit is contained in:
Qazzquimby 2019-03-07 14:35:40 -08:00 committed by Niclas
parent ec9ad3b3b1
commit aed268c09c

View file

@ -6,18 +6,17 @@ A client controlled Wayland compositor.
Configuration Configuration
------------- -------------
Configuration languages are confusing. They are neither flexible nor easy to use. Moreover, it adds a lot of complexity to the program itself. Configuration languages are confusing. They are neither flexible nor easy to use. Moreover, they add significant complexity to the program itself.
kiwmi listens to a socket and offers a basic client, kiwmic, to communicate with kiwmi. Much like how bspwm works. kiwmi listens to a socket and offers a basic client, kiwmic, to communicate with kiwmi, similarly to how bspwm works.
This allows the user to write the configuration in any langauge, e.g. as a bash script, which allows for high flexibility. This allows the user to write the configuration in any langauge, e.g. as a bash script, which allows for high flexibility.
On top of that, kiwmi barely handles anything on it's own. kiwmi handles almost nothing on it's own, and instead it emits events, to which the client can subscribe and react accordingly.
Instead it emmits events, to which the client can subscribe and react accordingly. This allows for 100% flexibility and customizability, while requiring little overhead effort.
This allows for 100% flexibility and customizability, while comming at a little effort at first. New user configurations will be linked as they are created, to help new users get started.
As soon as they exist I'll link a few user configurations, that are likely to help you get started.
This means the user will end up using a big, monolithic frontend, or a collection of small scripts, to configure kiwmi. kiwmi will end up being configured by a monolithic frontend, or collection of small scripts.
If I get around to it I will probably create a small Python (probably) library, to make it easier to create a monolithic frontend. A small (probably) Python library may be created to aid creating a monolithic frontend.
Dependencies Dependencies
------------ ------------
@ -30,14 +29,16 @@ Dependencies
Building Building
-------- --------
Make sure all dependencies are installed. Then run this. Make sure all dependencies are installed.
Run:
---- ----
$ meson build $ meson build
$ ninja -C build $ ninja -C build
---- ----
You can then install it like this. Install with:
---- ----
# ninja -C build install # ninja -C build install