#993229 fontconfig: fclist FcPatternFormat(3) mismatch from documentation

Package:
fontconfig
Source:
fontconfig
Description:
generic font configuration library - support binaries
Submitter:
Thorsten Glaser
Date:
2021-08-29 00:30:04 UTC
Severity:
normal
#993229#5
Date:
2021-08-29 00:27:13 UTC
From:
To:
fc-list(1) refers to FcPatternFormat(3) for its -f parameter
(which, incidentally, is in a different, not installed by
default, package). The latter:

   fclist
          Expands to the output of the default output format of the
          fc-list command on the pattern, without the final newline.

This is however untrue:

tglase@tglase-nb:~ $ fc-list -f '%{=fclist}\n' | fgrep Umpush-Light.otf
/usr/share/fonts/opentype/tlwg/Umpush-Light.otf: Umpush:familylang=en:style=Light:stylelang=en:fullname=Umpush Light:fullnamelang=en:slant=0:weight=50:width=100:foundry=PfEd:index=0:outline=True:scalable=True:charset=20-7e a0-ff 131 152-153 237 2bc 2c6-2c7 2d7 2da 2dc 303 331 e01-e3b e3f-e5b 2002-2003 200b-2010 2013-2015 2017-201e 2020-2022 2026 2030 2032-2033 2039-203a 203c 203e 2044 207f 2122 25cc f700-f720 fb00-fb04:lang=aa|ay|bi|br|ch|da|de|en|es|eu|fj|fo|fur|fy|gd|gl|gv|ho|ia|id|ie|io|is|it|lb|mg|nb|nds|nl|nn|no|nr|oc|om|pt|rm|sma|smj|so|sq|ss|st|sv|sw|th|tl|ts|uz|vo|wa|xh|yap|zu|an|fil|ht|jv|kj|kwm|li|ms|ng|pap-an|pap-aw|rn|rw|sc|sg|sn|su|za:fontversion=65667:capability=otlayout\:DFLT otlayout\:latn otlayout\:thai:fontformat=CFF:decorative=False:postscriptname=Umpush-Light:color=False:symbol=False:variable=False
tglase@tglase-nb:~ $ fc-list | fgrep Umpush-Light.otf
/usr/share/fonts/opentype/tlwg/Umpush-Light.otf: Umpush:style=Light

I’ve not checked whether the other ones are similarily untrue.


(Perhaps you also wish to move the FcPatternFormat(3) manpage,
and any others that are necessary for the section 1 manpages,
to the main package?)