Bug 5380 - README.fonts needs update for fontconfig multi-file configurations
Summary: README.fonts needs update for fontconfig multi-file configurations
Status: RESOLVED MOVED
Alias: None
Product: xorg
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 6.8.99.904 (6.9 RC4)
Hardware: All All
: medium minor
Assignee: Xorg Project Team
QA Contact: Xorg Project Team
URL:
Whiteboard: 2011BRB_Reviewed
Keywords:
Depends on:
Blocks:
 
Reported: 2005-12-19 14:20 UTC by Alan Coopersmith
Modified: 2018-08-10 21:37 UTC (History)
2 users (show)

See Also:
i915 platform:
i915 features:


Attachments

Description Alan Coopersmith 2005-12-19 14:20:10 UTC
The README.fonts currently distributed with X.org says:

  Fontconfig's behaviour is controlled by a set of configuration files: a sys-
  tem-wide configuration file, `/etc/fonts/fonts.conf', and a user-specific
  file called `.fonts.conf' in the user's home directory (this can be overrid-
  den with the `FONTCONFIG_FILE' environment variable).

This should be updated to describe the additional configuration file support
introduced in fontconfig 2.3.0:

  *  Support for local configuration directory provides a place for system
     distributors and administrators to make local changes to the font
     configuration without having to edit any configuration files.

Anyone want to volunteer some suggested text?
Comment 1 Alan Coopersmith 2005-12-21 10:08:43 UTC
Moving to 7.1 doc tracker.
Comment 2 Daniel Stone 2007-02-27 01:29:26 UTC
Sorry about the phenomenal bug spam, guys.  Adding xorg-team@ to the QA contact so bugs don't get lost in future.
Comment 3 Eric Anholt 2007-09-04 17:29:40 UTC
Haven't blocked a release on this yet, so clearing the status.
Comment 4 Jesse Adkins 2010-11-03 14:27:00 UTC
I can't find this file anywhere in xorg-docs, xserver, or...anywhere. I'm assuming that the file is gone, and thus the issue fixed.

If I'm wrong, can someone point me to where this is so I can try to fix this?
Comment 5 Alan Coopersmith 2010-11-03 14:40:56 UTC
The source file (as of last night when I renamed it) is:
http://cgit.freedesktop.org/xorg/doc/xorg-docs/tree/general/fonts/fonts.xml

The formatted output generated for X11R7.5 last year is at:
http://www.x.org/releases/X11R7.5/doc/fonts/fonts.html
Comment 6 Jesse Adkins 2010-11-06 12:03:13 UTC
How about :

Fontconfig's behaviour is controlled by a system-wide configuration directory, and by a user specific file. The system-wide configuration directory is located at `/etc/fonts/conf.d'. Fontconfig will scan all files inside of this directory that start with a number (0-9). The files are parsed in descending order (so 0.conf would be parsed before 1.conf, which is before 2.conf, and so on). The user-specific file named `.fonts.conf' is in the user's home directory (but can be overridden by the `FONTCONFIG_FILE' environment variable).
Comment 7 Alan Coopersmith 2010-11-10 00:25:26 UTC
(In reply to comment #6)
> How about :
> 
> Fontconfig's behaviour is controlled by a system-wide configuration directory,
> and by a user specific file. The system-wide configuration directory is located
> at `/etc/fonts/conf.d'. Fontconfig will scan all files inside of this directory
> that start with a number (0-9). The files are parsed in descending order (so
> 0.conf would be parsed before 1.conf, which is before 2.conf, and so on). The
> user-specific file named `.fonts.conf' is in the user's home directory (but can
> be overridden by the `FONTCONFIG_FILE' environment variable).

Sounds pretty good - but isn't /etc/fonts/fonts.conf also still used in addition
to the conf.d files?   Also, 0, 1, 2,... sounds like ascending order, not 
descending order, to me.
Comment 8 Jesse Adkins 2010-11-14 22:52:19 UTC
(In reply to comment #7)
> (In reply to comment #6)
> > How about :
> > 
> > Fontconfig's behaviour is controlled by a system-wide configuration directory,
> > and by a user specific file. The system-wide configuration directory is located
> > at `/etc/fonts/conf.d'. Fontconfig will scan all files inside of this directory
> > that start with a number (0-9). The files are parsed in descending order (so
> > 0.conf would be parsed before 1.conf, which is before 2.conf, and so on). The
> > user-specific file named `.fonts.conf' is in the user's home directory (but can
> > be overridden by the `FONTCONFIG_FILE' environment variable).
> 
> Sounds pretty good - but isn't /etc/fonts/fonts.conf also still used in
> addition
> to the conf.d files?   Also, 0, 1, 2,... sounds like ascending order, not 
> descending order, to me.
I get those mixed up sometimes. Ascending it is then. As for being used in addition to conf.d files, I assume so. So let's try...

Fontconfig's behaviour is controlled by a system-wide configuration directory,
and by two files. The system-wide configuration directory is located at `/etc/fonts/conf.d'. Fontconfig will scan all files inside of this directory that start with a number (0-9). The files are parsed in descending order (so
0.conf would be parsed before 1.conf, which is before 2.conf, and so on). The first file is a system-wide file named `/etc/fonts/fonts.conf'. The second is a
user-specific file named `.fonts.conf' is in the user's home directory (but can
be overridden by the `FONTCONFIG_FILE' environment variable).
Comment 9 Jeremy Huddleston Sequoia 2011-10-06 10:12:02 UTC
It seems like this has a fix.  Was it never pushed or the bug never closed?
Comment 10 GitLab Migration User 2018-08-10 21:37:35 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to freedesktop.org's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.freedesktop.org/xorg/doc/xorg-docs/issues/1.


Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.