From c70505d7c7b7b48600f273357694b56ccf5d2a15 Mon Sep 17 00:00:00 2001
From: Leonard Kugis <leonard@kug.is>
Date: Fri, 23 May 2025 11:41:09 +0000
Subject: Initial commit

---
 dwl-patches/patches/modes/README.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 dwl-patches/patches/modes/README.md

(limited to 'dwl-patches/patches/modes/README.md')

diff --git a/dwl-patches/patches/modes/README.md b/dwl-patches/patches/modes/README.md
new file mode 100644
index 0000000..c855af9
--- /dev/null
+++ b/dwl-patches/patches/modes/README.md
@@ -0,0 +1,35 @@
+### Description
+Implement  modes, that way each mapping is associated with a mode and is only active while in that mode, default mode is `NORMAL`
+
+### Example
+
+In the example below, you declare a mode: `BROWSER`, which is activated when you press <kbd>modkey</kbd> + <kbd>b</kbd>. Then, you can press <kbd>f</kbd> to launch `Firefox` and return to the default `NORMAL` mode.
+
+```c
+enum {
+  BROWSER,
+};
+const char *modes_labels[] = {
+  "browser",
+};
+
+static const Key keys[] = {
+  // ...
+  { MODKEY, XKB_KEY_b, entermode, {.i = BROWSER} },
+  // ...
+};
+
+static const Modekey modekeys[] = {
+  /* mode      modifier                  key                 function        argument */
+  { BROWSER, { 0, XKB_KEY_f, spawn, SHCMD("firefox") } },
+  { BROWSER, { 0, XKB_KEY_f, entermode, {.i = NORMAL} } },
+  { BROWSER, { 0, XKB_KEY_Escape, entermode, {.i = NORMAL} } },
+};
+```
+
+### Download
+- [git branch](https://codeberg.org/wochap/dwl/src/branch/v0.5/modes)
+- [v0.5](https://codeberg.org/dwl/dwl-patches/raw/branch/main/patches/modes/modes.patch)
+
+### Authors
+- [wochap](https://codeberg.org/wochap)
-- 
cgit v1.2.3