FONTS-CONFIG(1)  FONTS-CONFIG(1) NAME fonts-config - configures installed X11 fonts. SYNOPSISfonts-config [

OPTION]...

OPTIONS-f, --force

Force  the  update  of  all  generated  files  even if it appears  to  be  unnecessary  according  to  the  timestamps.

-q, --quietWork silently, unless an error occurs. -v, --verbosePrint some progress messages to standard output. -d, --debugPrint a lot of debugging messages to standard output. --(no)gs-fontmapgenerate (or don't generate)  a Fontmap for Ghostscript. --(no)ttcapgenerate (or don't generate) TTCap entries. TTCap entries can be used with the xtt module and with

recent versions of the freetype module. --(no)ooogenerate (or don't generate) font setup for OpenOffice

--versionDisplay version and exit. -h, --helpDisplay a short help message and exit. DESCRIPTIONConfigures installed X11 fonts. Basically it does the following things:

call fc-cachecreates  cache  files  for  fonts  to  use  with  client  side  font  rendering  via  libXft,  for  details  see

fc-cache (1). fonts.cache-1 cache  files  are  generated  in  all  directories  which  are  configured  in/etc/fonts/fonts.conf and all their subdirectories.

call cidfont-x11-configcidfont-x11-config  is  another  little  perl  script  which  configures  CID-keyed  fonts  for  use  with  X11,

see cidfont-x11-config (1). creates fonts.scale and fonts.dir filesTo find the list of directories currently used for server side fonts, /etc/X11/XF86Config is parsed and

merged with a hardcoded list of directories. If the font server xfs is running, /etc/X11/fs/config is alsoparsed and the list of directories found there is merged as well.

For each directory from this list, the time stamps of the directory, the fonts.scale file, the fonts.dir fileand  an  extra  time  stamp  file .fonts-config-timestamp are  checked.  If not  all  the  time  stamps  are equal or any of these files is missing, the fonts.scale and fonts.dir files will be updated as follows: First of all a fonts.scale file is created by calling mkfontscale. Then, the entries found in the fonts.scale file are merged with the entries from all fonts.scale.* files. fonts.scale.* files  may  be  supplied  by  rpm-packages  or  manually  added  by  the  user  to  override  oramend the entries created automatically by mkfontscale. Entries in a fonts.scale.* file have higher priority  than  entries  automatically  created  by mkfontscale. All  entries  generated  automatically  bymkfontscale for a certain font file are discarded if any fonts.scale.* file contains an entry for the same

perl v5.8.6 2004-12-06  1

FONTS-CONFIG(1)  FONTS-CONFIG(1)

font file. If the xtt module is configured to load in /etc/X11/XF86Config, additional entries may be created tomake use of the artificial bold and italic features of xtt. The time stamp of /etc/X11/XF86Config is

not checked, i.e. you have to use fonts-config --force after editing /etc/X11/XF86Config to switchbetween the xtt and freetype modules.

After the final list of entries has been written back to fonts.scale, mkfontdir is called. Finally, the time stamps of the directory, fonts.scale, fonts.dir, and .fonts-config-timestamp are setto the time when fonts-config started.

If any fonts.scale file in the directory list needed an update, a Ghostcript Fontmap is also generated forall  scalable  fonts  in  the  directory  list  and  the  result  is  written  to /usr/share/ghostscript/*/lib/Fontmap.X11-auto. Usually fonts-config is called automatically via SuSEconfig (SuSEconfig --module fonts), which is usu-ally automatically called by YaST2. But you can also execute fonts-config directly, which is mainly useful

to debug it. FILES /etc/sysconfig/fonts-config

Default values for some command line options of fonts-config are read from this file if it exists.  Theoptions currently supported in this file are:

GENERATE_TTCAP_ENTRIEScan be set to ``yes'' or ``no'' and sets the default for the option --(no)ttcap. GENERATE_GHOSTSCRIPT_FONTMAPScan be set to ``yes'' or ``no'' and sets the default for the option --(no)gs-fontmap. GENERATE_OOO_FONT_SETUPcan be set to ``yes'' or ``no'' and sets the default for the option --(no)ooo. SEE ALSO

fc-cache (1), cidfont-x11-config (1), mkfontdir (1), mkfontscale (1)

AUTHORMike

FABIAN <mfabian@suse.de>, 2003.

perl v5.8.6 2004-12-06  2