From af6638f1e7f65b84d6c47c31935e1c60e9851536 Mon Sep 17 00:00:00 2001
From: deadc0de6 <info@deadc0de.ch>
Date: Wed, 9 Oct 2024 10:24:37 +0200
Subject: [PATCH] adding dconf doc

---
 docs/howto/manage-dconf-settings.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 docs/howto/manage-dconf-settings.md

diff --git a/docs/howto/manage-dconf-settings.md b/docs/howto/manage-dconf-settings.md
new file mode 100644
index 0000000..4c67e32
--- /dev/null
+++ b/docs/howto/manage-dconf-settings.md
@@ -0,0 +1,24 @@
+# Manage dconf settings
+
+Here is an example (thanks [@gmvelencoso](https://github.com/gmvelencoso)) 
+using dotdrop to manage dconf settings:
+
+```yaml
+actions:
+  dconf_load: dconf load "{0}" < "{{@@ _dotfile_abs_src @@}}"
+trans_update:
+  dconf_dump: dconf dump "{2}" > "{1}"
+dconf_tilix:
+    src: config/tilix/tilix.dconf
+    dst: /tmp/tilix.dconf 
+    actions:
+      - dconf_load /com/gexperts/Tilix/
+    trans_update: dconf_dump /com/gexperts/Tilix/
+    link: nolink
+````
+
+On `install`/`compare`, the [action](../config/config-actions.md) `dconf_load` will call `dconf` to load
+the configuration from the file stored in the *dotpath* under `config/tilix/tilix.dconf`.
+
+On `update`, the [transformation](../config/config-transformations.md) `trans_update` will dump the configuration
+entry and use it to update the file in the *dotpath*.