real readme

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