From c3f20ee473af00c8e9fe83e5cee550a46c7cae38 Mon Sep 17 00:00:00 2001
From: Přemysl Eric Janouch <p@janouch.name>
Date: Tue, 26 Nov 2024 02:28:41 +0100
Subject: Improve README.adoc

---
 README.adoc | 44 ++++++++++++++++++++++++++++++++++----------
 1 file changed, 34 insertions(+), 10 deletions(-)

(limited to 'README.adoc')

diff --git a/README.adoc b/README.adoc
index 174da0e..06bc869 100644
--- a/README.adoc
+++ b/README.adoc
@@ -2,22 +2,46 @@ USB drivers
 ===========
 :compact-option:
 
-_usb-drivers_ is a collection of utilities to control various hardware over USB:
+_usb-drivers_ is a collection of utilities to control various hardware over USB.
+
+Utility overview
+----------------
+
+eizoctl
+~~~~~~~
+_eizoctl_ controls elementary settings of EIZO computer monitors, which do not
+support DDC/CI.  Say no to oily stains on your monitor's frame!
+
+ $ eizoctl --brightness +0.5 --input USB-C
 
- - _eizoctl_ controls elementary settings of EIZO computer monitors.
-+
 It is intended as a replacement for official EIZO software,
 and may not run at the same time, as it would contend for device access.
 
- - _eizoctltray_ is a derived Windows utility that can stay in the systray.
+eizoctltray
+~~~~~~~~~~~
+_eizoctltray_ is a derived Windows utility that can stay in the systray.
+When holding the Shift or Control keys while switching singnal inputs,
+it will also suspend or power off the system, respectively.
+
+image::eizoctltray.png["eizoctltray with expanded context menu", 343, 229]
+
+elksmart-comm
+~~~~~~~~~~~~~
+_elksmart-comm_ interfaces with ELK Smart infrared dongles EKX4S and EKX5S-T,
+partially reimplementing the Ocrustar mobile app.  It can both receive and send,
+although the older dongle is extremely unreliable at receiving.
+
+To mimic the Nikon ML-L3 infrared wireless remote control:
+
+ $ elksmart-comm 80ffffffffffffc71c5f1bda1bffffffffffffffffffffffffffffff3a7bffffffffffff99185f1bda1b03
+
+While it does not build for Windows, this is incidental.
 
- - _elksmart-comm_ interfaces with ELK Smart infrared dongles,
-   partially reimplementing the Ocrustar mobile app.
-   While it does not build for Windows, this is incidental.
+razer-bw-te-ctl
+~~~~~~~~~~~~~~~
+_razer-bw-te-ctl_ makes it possible to change the configuration of your Razer
+BlackWidow Tournament Edition keybooard (the 2012 model).
 
- - _razer-bw-te-ctl_ makes it possible to change the configuration of your Razer
-   BlackWidow Tournament Edition keybooard.
-+
 Make sure to let the Windows Razer Synapse tool upgrade the firmware to the
 newest version before running the program.  There might be some issues otherwise
 due to protocol changes, although I don't really deem it very probable.
-- 
cgit v1.2.3-70-g09d2

