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

[Thorsten Glaser]

Package: fontconfig
Version: 2.13.1-4.2
Severity: normal
X-Debbugs-Cc: tg at mirbsd.de

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 at 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 at 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?)


-- System Information:
Debian Release: 11.0
  APT prefers stable-security
  APT policy: (500, 'stable-security'), (500, 'stable-debug'), (500, 'oldstable-updates'), (500, 'oldoldstable'), (500, 'stable'), (500, 'oldstable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 5.10.0-8-amd64 (SMP w/2 CPU threads)
Kernel taint flags: TAINT_WARN
Locale: LANG=C.UTF-8, LC_CTYPE=C.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /bin/lksh
Init: sysvinit (via /sbin/init)

Versions of packages fontconfig depends on:
ii  fontconfig-config  2.13.1-4.2
ii  libc6              2.31-13
ii  libfontconfig1     2.13.1-4.2
ii  libfreetype6       2.10.4+dfsg-1

fontconfig recommends no packages.

fontconfig suggests no packages.

-- no debconf information