From 64062b2a94eadcf883ff9a70c785bde0fb52f93e Mon Sep 17 00:00:00 2001
From: Dave Davenport <qball@blame.services>
Date: Sat, 22 Jan 2022 14:20:16 +0100
Subject: [PATCH] [Doc] Add F.A.Q about icon lookup.

---
 doc/rofi.1          | 15 +++++++++++++++
 doc/rofi.1.markdown |  9 +++++++++
 2 files changed, 24 insertions(+)

diff --git a/doc/rofi.1 b/doc/rofi.1
index f6447ab6..f930b656 100644
--- a/doc/rofi.1
+++ b/doc/rofi.1
@@ -1332,6 +1332,21 @@ The indicator shows:
 .fi
 .RE
 
+.SS Why do I see different icons for run,drun and window mode
+.PP
+Each of these modes uses different methods of resolving the icon:
+
+.RS
+.IP \(bu 2
+Window: It first uses the icon that the application exposes via the X11
+Server, if none is set it does a lookup of the window Class name in the icon theme.
+.IP \(bu 2
+drun: It uses the icon set in the desktop file.
+.IP \(bu 2
+run: It does a lookup using the executable name.
+
+.RE
+
 .SH EXAMPLES
 .PP
 Some basic usage examples of \fBrofi\fP:
diff --git a/doc/rofi.1.markdown b/doc/rofi.1.markdown
index 9d23e12b..d70ea4ab 100644
--- a/doc/rofi.1.markdown
+++ b/doc/rofi.1.markdown
@@ -844,6 +844,15 @@ The indicator shows:
     `+` Case insensitive and Sorting enabled
     `±` Sorting and Case sensitivity enabled"
 
+### Why do I see different icons for run,drun and window mode
+
+Each of these modes uses different methods of resolving the icon:
+
+* Window: It first uses the icon that the application exposes via the X11
+  Server, if none is set it does a lookup of the window Class name in the icon theme.
+* drun: It uses the icon set in the desktop file.
+* run: It does a lookup using the executable name.
+
 ## EXAMPLES
 
 Some basic usage examples of **rofi**: