[IconFetcher] Add support for font rendering as icon.

Issue: #1132

1 files changed, 48 insertions, 0 deletions

diff --git a/doc/rofi.1 b/doc/rofi.1
index 32099941..d50c5cb3 100644
--- a/doc/rofi.1
+++ b/doc/rofi.1
@@ -1328,6 +1328,54 @@ modes are shown, even if the rest of the input text would match results from \fB
 If no match, the input is handled by the first combined modes.
 
 .SH FAQ
+.SS What icon formats are supported
+.PP
+Rofi supports 3 ways of specifying an icon:
+
+.RS
+.IP \(bu 2
+Filename
+.IP \(bu 2
+icon-name, this is looked up via the icon-theme.
+.IP \(bu 2
+Markup String. It renders a string as an icon.
+
+.RE
+
+.PP
+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 \fB\fC<span\fR tag, that allows you to set color and font.
+
+.PP
+Markup string:
+
+.PP
+.RS
+
+.nf
+echo -en "testing\\0icon\\x1f<span color='red'>⏻</span>" | ./rofi -dmenu
+
+.fi
+.RE
+
+.PP
+Getting supported icon formats:
+
+.PP
+.RS
+
+.nf
+G_MESSAGES_DEBUG=Helpers.IconFetcher rofi
+
+.fi
+.RE
+
+.PP
+This uses the debug framework and prints out a list of supported image  file
+extensions.
+
 .SS The text in the window switcher is not nicely aligned.
 .PP
 Try using a mono-space font.