From 29554720167691b7f67bf3274eeb367b0fa4df41 Mon Sep 17 00:00:00 2001
From: Deven Blake <blakedevendesu@gmail.com>
Date: Sun, 16 May 2021 11:29:23 -0400
Subject: [PATCH] real readme

---
 dmenubar/README.md | 29 +++++++++++++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/dmenubar/README.md b/dmenubar/README.md
index 361f21f..23a8426 100644
--- a/dmenubar/README.md
+++ b/dmenubar/README.md
@@ -3,9 +3,34 @@
 dmenu is an efficient dynamic menu for X.
 dmenubar is a HACK of dmenu that displays a menu bar.
 
-** There are no guarantees at any time that this project works or is stable. Please don't rely on it. **
+## Why
 
-Lemonbar is an excellent replacement.
+lemonbar [can't do TTF fonts](https://github.com/LemonBoy/bar/issues/188).
+
+dmenubar intends to be a knockoff of lemonbar that can do TTF, basically.
+I tore out a ton of the dmenu code, made stdin feed into the dmenu prompt, and
+presto flavo. Code's not great but dmenubar.c (where most of the changes are)
+is only ~300 lines so it could be worse.
+
+## You shouldn't use this
+
+If you use any features of lemonbar outside of the default settings you
+probably won't be able to make dmenubar fit your workflow.
+
+The biggest issue is dmenubar draws *over* other windows the same way dmenu
+does. I have my keybindings like this in sxhkd so I can pull up dmenubar and
+then kill it when I'm done looking:
+
+```
+mod1 + i
+        ps x | grep dmenubar | grep -v grep && pkill dmenubar; \
+        show_bar_stuff | /home/trinity/src/dmenubar/dmenubar -b
+
+mod1 + shift + i
+        pkill dmenubar
+```
+
+*Maybe* somebody will prefer this over how lemonbar does it? I don't know.
 
 ## Requirements