fontconfig: Branch 'main'

[GitLab Mirror <gitlab-mirror@xxxxxxxxxxxxxxxxxxxxxx>]

 doc/fontconfig-user.sgml |    5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

New commits:
commit 7e2a1b2577e8d90ea5be3f14091e809ac7742438
Author: Akira TAGOH <akira@xxxxxxxxx>
Date:   Mon Jun 12 19:59:53 2023 +0900

    Add more docs about selectfont
    
    Fixes https://gitlab.freedesktop.org/fontconfig/fontconfig/-/issues/363

diff --git a/doc/fontconfig-user.sgml b/doc/fontconfig-user.sgml
index eba13e1..917bec7 100644
--- a/doc/fontconfig-user.sgml
+++ b/doc/fontconfig-user.sgml
@@ -385,7 +385,10 @@ automatically rebuild the internal datastructures when this interval passes.
   </para></refsect2>
   <refsect2><title><literal>&lt;selectfont&gt;</literal></title><para>
 This element is used to deny/allow list fonts from being listed or matched
-against.  It holds acceptfont and rejectfont elements.
+against.  It holds acceptfont and rejectfont elements.  This list is applied
+only once when caches is loaded.  So if you want to filter out by some patterns,
+patterns is evaluated with something in cache only.
+In other words, target patterns except "scan" won't takes any effects.
   </para></refsect2>
   <refsect2><title><literal>&lt;acceptfont&gt;</literal></title><para>
 Fonts matched by an acceptfont element are "allowlisted"; such fonts are