[IconFetcher] Add support for font rendering as icon.

Issue: #1132

1 files changed, 28 insertions, 0 deletions

diff --git a/doc/rofi.1.markdown b/doc/rofi.1.markdown
index 91c844df..8c2c92f9 100644
--- a/doc/rofi.1.markdown
+++ b/doc/rofi.1.markdown
@@ -857,6 +857,34 @@ If no match, the input is handled by the first combined modes.
 
 ## FAQ
 
+### What icon formats are supported
+
+Rofi supports 3 ways of specifying an icon:
+
+* Filename
+* icon-name, this is looked up via the icon-theme.
+* Markup String. It renders a string as an icon.
+
+
+For the first two options, GdkPixbuf is used to open and render the icons.
+This in general gives support for most required image formats.
+For the string option it uses Pango to render the string. The string needs to
+start with a `<span` tag, that allows you to set color and font.
+
+Markup string:
+
+```bash
+echo -en "testing\0icon\x1f<span color='red'>⏻</span>" | ./rofi -dmenu
+```
+
+Getting supported icon formats:
+
+```bash
+G_MESSAGES_DEBUG=Helpers.IconFetcher rofi
+```
+This uses the debug framework and prints out a list of supported image  file
+extensions.
+
 ### The text in the window switcher is not nicely aligned.
 
 Try using a mono-space font.