From 39e5145258d6cdf189d973b7acf9d8fb98f7e5ee Mon Sep 17 00:00:00 2001
From: Philipp Gesang <phg@phi-gamma.net>
Date: Sun, 12 Dec 2021 01:35:28 +0100
Subject: doc: describe led setting in readme and manpage

---
 Cargo.toml    |  2 +-
 README.rst    |  5 +++++
 doc/vtcol.rst | 16 ++++++++++++----
 3 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 2e1bd70..d1b2c5a 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -5,7 +5,7 @@
 [package]
 name        = "vtcol"
 description = "Set Linux console color scheme"
-version     = "0.42.6"
+version     = "0.42.7"
 authors     = [ "Philipp Gesang <phg@phi-gamma.net>" ]
 repository  = "https://github.com/phi-gamma/vtcol"
 keywords    = [ "linux", "virtual_terminal", "tty", "console", "system" ]
diff --git a/README.rst b/README.rst
index 9c07b63..15cf652 100644
--- a/README.rst
+++ b/README.rst
@@ -78,6 +78,11 @@ Show the current state of the keyboard LEDs: ::
     $ vtcol leds get
     caps: false, num: true, scroll: false
 
+Set the state of the Caps Lock LED (does *not* affect the Caps Lock state, just
+the LED itself): ::
+
+    $ vtcol leds set --caps on
+
 Building
 -------------------------------------------------------------------------------
 
diff --git a/doc/vtcol.rst b/doc/vtcol.rst
index 8531a18..a93cdf4 100644
--- a/doc/vtcol.rst
+++ b/doc/vtcol.rst
@@ -6,8 +6,8 @@
                      color schemes for the Linux™ console 
 *******************************************************************************
 
-:Date:                  2021-12-11
-:Version:               0.42.6
+:Date:                  2021-12-12
+:Version:               0.42.7
 :Manual section:        1
 :Manual group:          console
 
@@ -105,14 +105,22 @@ vtcol leds commands
 
 **get**
 
-    Get the current led state. Example: ::
+    Get the current LED state. Example: ::
 
         $ vtcol leds get
         caps: false, num: false, scroll: false
 
 **set**
 
-.. TODO:: unimplemented!()
+    Set the state of individual keyboard LEDs: ::
+
+        $ vtcol leds set --caps on --num off
+
+    Not that this command only affects the LEDs themselves. It will not change
+    the state of the corresponding modifier locks. Revert the LEDs to normal:
+    ::
+
+        $ vtcol leds set --revert
 
 colors set options
 -------------------------------------------------------------------------------
-- 
cgit v1.2.3