cache: write about kdb cache tool
@@ -25,11 +25,18 @@ POSIX compliant system (including XSI extensions).
The plugin is only compiled if the plugins `resolver` and `mmapstorage`
are also available.
+## Location of Cache
+
+The cache files are located in the user's home directory below `~/.cache/elektra/` and
+shall not be altered, otherwise the behavior is undefined. If `XDG_CACHE_HOME` is set, the
+cache files are located below `$XDG_CACHE_HOME/elektra`.
+
+## Configuration of Cache
+
+Use the tool `kdb cache` to enable, disable or clear the cache.
+
## Limitations
Incompatible with storage plugins, which do not always produce the same keyset on any invocation
concerning the same configuration file. A notable example here is the `ini` plugin (see issue #2592).
-The cache files are located in the user's home directory below `~/.cache/elektra/` and
-shall not be altered, otherwise the behavior is undefined. If `XDG_CACHE_HOME` is set, the
-cache files are located below `$XDG_CACHE_HOME/elektra`.
