Font sort function PURPOSE fields are unclear
The PURPOSE
fields in doc
for a couple of functions related to sorting lists of fonts are unclear:
-
FcFontSort
(indoc/fcconfig.fncs
) says "Return list of matching fonts", but the results aren't necessarily limited to fonts that match the requested pattern -
FcFontSetSort
(indoc/fcfontset.fncs
) says "Add to a font set", but it does nothing of the sort (this appears to have been erroneously copied fromFcFontSetAdd
)
I'd recommend changing these to "Return a sorted set of fonts" and "Sort a set of fonts".