[Fontconfig] Doc for fonts.conf? ("no fonts found error")

[Keith Packard]

Around 10 o'clock on Feb 23, Laurent Moussault wrote:

> Is there any documentation for 'fonts.conf' and about how fontconfig
> finds font in the specified directories (e.g. what extension does it
> recongize, does it look into subdirs...)?

The fontconfig(3) man page is the only current documentation.  And, yes, 
fontconfig looks in subdirectories.  It relies upon FreeType2 to tell 
which files contains valid fonts, so any file FreeType2 can open, 
fontconfig will advertise.

> Or, is there a way to know what fonts the fontconfig library find
> (what is the algorithm used to browsed the directories specified in
> fonts.conf)?

Fontconfig comes with a diagnostic program 'fc-list' which can be used to 
display the available fonts.

-keith