Apply smack label for /opt/share/fonts path
[platform/upstream/fontconfig.git] / doc / fonts-conf.5
index 55cc3cd..197b70c 100644 (file)
@@ -1,5 +1,5 @@
 .\" auto-generated by docbook2man-spec from docbook-utils package
-.TH "FONTS-CONF" "5" "10 1月 2013" "" ""
+.TH "FONTS-CONF" "5" "05 8月 2016" "" ""
 .SH NAME
 fonts.conf \- Font configuration files
 .SH SYNOPSIS
@@ -81,10 +81,11 @@ convenience for the applications' rendering mechanism.
   file            String  The filename holding the font
   index           Int     The index of the font within the file
   ftface          FT_Face Use the specified FreeType face object
-  rasterizer      String  Which rasterizer is in use
+  rasterizer      String  Which rasterizer is in use (deprecated)
   outline         Bool    Whether the glyphs are outlines
   scalable        Bool    Whether glyphs can be scaled
-  scale           Double  Scale factor for point->pixel conversions
+  color           Bool    Whether any glyphs have color
+  scale           Double  Scale factor for point->pixel conversions (deprecated)
   dpi             Double  Target dots per inch
   rgba            Int     unknown, rgb, bgr, vrgb, vbgr,
                           none - subpixel geometry
@@ -95,7 +96,15 @@ convenience for the applications' rendering mechanism.
                           font supports
   fontversion     Int     Version number of the font
   capability      String  List of layout capabilities in the font
+  fontformat      String  String name of the font format
   embolden        Bool    Rasterizer should synthetically embolden the font
+  embeddedbitmap  Bool    Use the embedded bitmap instead of the outline
+  decorative      Bool    Whether the style is a decorative variant
+  fontfeatures    String  List of the feature tags in OpenType to be enabled
+  namelang        String  Language name to be used for the default value of
+                          familylang, stylelang, and fullnamelang
+  prgname         String  String  Name of the running program
+  postscriptname  String  Font family name in PostScript
     
 .sp
 .fi
@@ -213,7 +222,7 @@ debugging messages.
   MEMORY         512    Monitor fontconfig memory usage
   CONFIG        1024    Monitor which config files are loaded
   LANGSET       2048    Dump char sets used to construct lang values
-  OBJTYPES      4096    Display message when value typechecks fail
+  MATCH2        4096    Display font-matching transformation in patterns
   
 .sp
 .fi
@@ -277,9 +286,9 @@ the configuration file, the directory that can be accessed first in the list
 will be used to store the cache files. If it starts with '~', it refers to
 a directory in the users home directory. If 'prefix' is set to "xdg", the value in the XDG_CACHE_HOME environment variable will be added as the path prefix. please see XDG Base Directory Specification for more details.
 The default directory is ``$XDG_CACHE_HOME/fontconfig'' and it contains the cache files
-named ``<hash value>-<architecture>\&.cache-<version\&'',
-where <version> is the font configureation file
-version number (currently 3).
+named ``<hash value>-<architecture>\&.cache-<version>\&'',
+where <version> is the font configuration file
+version number (currently 5).
 .SS "<INCLUDE IGNORE_MISSING=""NO"" PREFIX=""DEFAULT"">"
 .PP
 This element contains the name of an additional configuration file or
@@ -389,6 +398,8 @@ with "same" binding using the value from the matched pattern element.
   "prepend_first"         Insert at head of list  Insert at head of list
   "append"                Append after matching   Append at end of list
   "append_last"           Append at end of list   Append at end of list
+  "delete"                Delete matching value   Delete all values
+  "delete_all"            Delete all values       Delete all values
     
 .sp
 .fi
@@ -438,6 +449,8 @@ symbolic names for common font values:
   extralight      weight          40
   ultralight      weight          40
   light           weight          50
+  demilight       weight          55
+  semilight       weight          55
   book            weight          75
   regular         weight          80
   normal          weight          80
@@ -728,6 +741,9 @@ is used to override the default configuration directory.
 \fBFC_DEBUG\fR
 is used to output the detailed debugging messages. see Debugging Applications section for more details.
 .PP
+\fBFC_DBG_MATCH_FILTER\fR
+is used to filter out the patterns. this takes a comma-separated list of object names and effects only when FC_DEBUG has MATCH2. see Debugging Applications section for more details.
+.PP
 \fBFONTCONFIG_USE_MMAP\fR
 is used to control the use of mmap(2) for the cache files if available. this take a boolean value. fontconfig will checks if the cache files are stored on the filesystem that is safe to use mmap(2). explicitly setting this environment variable will causes skipping this check and enforce to use or not use mmap(2) anyway.
 .SH "SEE ALSO"
@@ -735,4 +751,4 @@ is used to control the use of mmap(2) for the cache files if available. this tak
 fc-cat(1), fc-cache(1), fc-list(1), fc-match(1), fc-query(1)
 .SH "VERSION"
 .PP
-Fontconfig version 2.10.91
+Fontconfig version 2.12.1