From 2fadd3e7bacaf0328c4459d85dd3ced23aa5426a Mon Sep 17 00:00:00 2001
From: Kovid Goyal <kovid@kovidgoyal.net>
Date: Sun, 15 Sep 2019 04:09:26 +0530
Subject: [PATCH] Add a note to the fontconfig FAQ about how to override
 spacing

---
 docs/faq.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/faq.rst b/docs/faq.rst
index dba97c702..0c21f39b3 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -154,6 +154,26 @@ monospace. On Linux you can list all monospace fonts with::
 
     fc-list : family spacing | grep spacing=100
 
+Note that the spacing property is calculated by fontconfig based on actual
+glyph widths in the font. If for some reason fontconfig concludes your favorite
+monospace font does not have ``spacing=100`` you can override it by using the
+following :file:`~/.config/fontconfig/fonts.conf`::
+
+    <?xml version="1.0"?>
+    <!DOCTYPE fontconfig SYSTEM "fonts.dtd">
+    <fontconfig>
+    <match target="scan">
+        <test name="family">
+            <string>Your Font Family Name</string>
+        </test>
+        <edit name="spacing">
+            <int>100</int>
+        </edit>
+    </match>
+    </fontconfig>
+
+Then, the font will be available in ``kitty list-fonts``.
+
 
 How can I assign a single global shortcut to bring up the kitty terminal?
 -----------------------------------------------------------------------------