From 791d4fb18df79a9cb2fddfd26a4cd8b4b59ddc37 Mon Sep 17 00:00:00 2001
From: patrick96
Date: Tue, 24 Mar 2020 21:17:25 +0100
Subject: [PATCH] Clarify Step 2 of font debugging
---
Fonts.md | 11 +++++++++--
1 file changed, 9 insertions(+), 2 deletions(-)
diff --git a/Fonts.md b/Fonts.md
index b25dd1b..4a642be 100644
--- a/Fonts.md
+++ b/Fonts.md
@@ -40,8 +40,15 @@ Follow these steps very carefully and in the order they are given and do not ski
1. **Confirm all fonts are loaded properly:**
To do that, follow the instructions in the [Finding Font Names](#finding-font-names) section.
-2. **Check that all the icons you use are available in the fonts used:**
-Use `gucharmap` to search (`Ctrl-F`) for the dropped characters (copy them from the terminal output), then switch to each font in your config, using the dropdown in the top left. For each font hold down right click on the highlighted character to show which font it's from. If that never shows any font from your config, you'll need to add the font for that character to your config.
+2. **Check that all the icons you use are available in the fonts used:**
+Use `gucharmap` and enable `View > Show only glyphs from this font` (**this is
+important**), then search (`Ctrl-F`) for the dropped characters (copy them from
+the terminal output), then switch to each font in your config, using the
+dropdown in the top left.
+If the desired icon never shows up, none of the fonts in your polybar config support that icon.
+To find a font that provides that icon, we suggest you use the [perl
+script](#find-fonts-for-glyphs) at the bottom of this page.
+Another way is to disable `Show only glyphs from this font` in `gucharmap`, the icon should now show up again, if it doesn't you don't have any font on your system that supports that icon. If it does show up, you can hold right click and it will show you the font it's from in the tooltip.
3. **Check font order:** If you have no more **`Dropping unmatched character`** warnings but the wrong icons are displayed, you may have a font conflict where two fonts provide a font icon in the same position (codepoint). Make sure that none of the fonts in the font list, before the font that the icon is from, have a character at the same position.
You can do that by changing the order in which you define the fonts, although this can lead to conflicts in the other direction. The safest way is to use the `-font` property or the `%{T}` tag to specify which font to use, as described at the beginning of this page.