Note minimum supported version for fontconfig.

anntzer · anntzer · commit 1e31eb0ebb24 · 2019-11-07T18:57:28.000+01:00
diff --git a/INSTALL.rst b/INSTALL.rst
@@ -150,7 +150,10 @@ etc., you can install the following:
 * `ImageMagick <https://www.imagemagick.org/script/index.php>`_: for saving
   animated gifs;
 * `LaTeX <https://miktex.org/>`_ and `GhostScript (>=9.0)
-  <https://ghostscript.com/download/>`_ : for rendering text with LaTeX.
+  <https://ghostscript.com/download/>`_ : for rendering text with LaTeX;
+* fontconfig_ (>= 2.7): for detection of system fonts on Linux.
+
+.. _fontconfig: https://www.fontconfig.org
 
 FreeType and Qhull
 ------------------
diff --git a/lib/matplotlib/font_manager.py b/lib/matplotlib/font_manager.py
@@ -273,6 +273,11 @@ def _call_fc_list():
         'This may take a moment.'))
     timer.start()
     try:
+        if '--format' not in subprocess.check_output(['fc-list', '--help']):
+            _log.warning(
+                # fontconfig 2.7 implemented --format.
+                'Matplotlib needs fontconfig>=2.7 to query system fonts.')
+            return []
         out = subprocess.check_output(['fc-list', '--format=%{file}\\n'])
     except (OSError, subprocess.CalledProcessError):
         return []
