Apply smack label for /opt/share/fonts path
[platform/upstream/fontconfig.git] / doc / fonts-conf.5
index 932d904..197b70c 100644 (file)
@@ -1,5 +1,5 @@
 .\" auto-generated by docbook2man-spec from docbook-utils package
-.TH "FONTS-CONF" "5" "26 11月 2012" "" ""
+.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
@@ -402,8 +413,9 @@ zero for purely fractional values (e.g. use 0.5 instead of .5 and -0.5
 instead of -.5).
 .SS "<MATRIX>"
 .PP
-This element holds the four <double> elements of an affine
-transformation.
+This element holds four numerical expressions of an affine transformation.
+At their simplest these will be four <double> elements
+but they can also be more involved expressions.
 .SS "<RANGE>"
 .PP
 This element holds the two <int> elements of a range
@@ -419,7 +431,12 @@ a RFC-3066-style languages or more.
 .SS "<NAME>"
 .PP
 Holds a property name. Evaluates to the first value from the property of
-the font, not the pattern.
+the pattern. If the 'target' attribute is not present, it will default to
+\&'default', in which case the property is returned from the font pattern
+during a target="font" match, and to the pattern during a target="pattern"
+match. The attribute can also take the values 'font' or 'pattern' to
+explicitly choose which pattern to use. It is an error to use a target
+of 'font' in a match that has target="pattern".
 .SS "<CONST>"
 .PP
 Holds the name of a constant; these are always integers and serve as
@@ -432,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
@@ -722,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"
@@ -729,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.2
+Fontconfig version 2.12.1