X-Git-Url: https://git.wh0rd.org/?a=blobdiff_plain;f=doc%2Ffontconfig-user.sgml;h=217feb97adcde17a8e0161dd98602c8ed4d37d13;hb=7baa20c7590b12d11dcfb0a50131d50963581258;hp=10077828f85b8a9535c8de7aab9684645850315c;hpb=b1aa20098f641a16d02e70a161450e6b85afe410;p=fontconfig.git diff --git a/doc/fontconfig-user.sgml b/doc/fontconfig-user.sgml index 1007782..217feb9 100644 --- a/doc/fontconfig-user.sgml +++ b/doc/fontconfig-user.sgml @@ -9,15 +9,15 @@ documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting - documentation, and that the name of Keith Packard not be used in + documentation, and that the name of the author(s) not be used in advertising or publicity pertaining to distribution of the software without - specific, written prior permission. Keith Packard makes no + specific, written prior permission. The authors make no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. - KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, + THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO - EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR + EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR @@ -37,6 +37,7 @@ &confdir;/fonts.conf &confdir;/fonts.dtd &confdir;/conf.d + ~/.fonts.conf.d ~/.fonts.conf @@ -120,6 +121,7 @@ convenience for the applications' rendering mechanism. dpi Double Target dots per inch rgba Int unknown, rgb, bgr, vrgb, vbgr, none - subpixel geometry + lcdfilter Int Type of LCD filter minspace Bool Eliminate leading from line spacing charset CharSet Unicode chars encoded by the font lang String List of RFC-3066-style languages this @@ -214,9 +216,9 @@ Here are some examples: with artificial obliquing -The '\', '-', ':' and ',' characters in family names must be preceeded by a +The '\', '-', ':' and ',' characters in family names must be preceded by a '\' character to avoid having them misinterpreted. Similarly, values -containing '\', '=', '_', ':' and ',' must also have them preceeded by a +containing '\', '=', '_', ':' and ',' must also have them preceded by a '\' character. The '\' characters are stripped out of the family name and values as the font name is read. @@ -429,6 +431,18 @@ instead of -.5). <literal><matrix></literal> This element holds the four <double> elements of an affine transformation. + + <literal><range></literal> +This element holds the two <int> elements of a range +representation. + + <literal><charset></literal> +This element holds at least one <int> element of +an Unicode code point or more. + + <literal><langset></literal> +This element holds at least one <string> element of +a RFC-3066-style languages or more. <literal><name></literal> Holds a property name. Evaluates to the first value from the property of @@ -476,6 +490,10 @@ symbolic names for common font values: vrgb rgba 3 vbgr rgba 4 none rgba 5 + lcdnone lcdfilter 0 + lcddefault lcdfilter 1 + lcdlight lcdfilter 2 + lcdlegacy lcdfilter 3 hintnone hintstyle 0 hintslight hintstyle 1 hintmedium hintstyle 2 @@ -641,14 +659,14 @@ This is an example of a per-user configuration file that lives in contains configuration information for the fontconfig library consisting of directories to look at for font information as well as instructions on editing program specified font patterns before attempting to -match the available fonts. It is in xml format. +match the available fonts. It is in XML format. conf.d is the conventional name for a directory of additional configuration files managed by external applications or the local administrator. The filenames starting with decimal digits are sorted in lexicographic order -and used as additional configuration files. All of these files are in xml +and used as additional configuration files. All of these files are in XML format. The master fonts.conf file references this directory in an <include> directive. @@ -657,6 +675,12 @@ format. The master fonts.conf file references this directory in an is a DTD that describes the format of the configuration files. +~/.fonts.conf.d +is the conventional name for a per-user directory of (typically +auto-generated) configuration files, although the +actual location is specified in the global fonts.conf file. + + ~/.fonts.conf is the conventional location for per-user font configuration, although the actual location is specified in the global fonts.conf file. @@ -669,7 +693,7 @@ per-directory caches. This file is automatically maintained by fontconfig. See Also -fc-cache(1), fc-match(1), fc-list(1) +fc-cat(1), fc-cache(1), fc-list(1), fc-match(1), fc-query(1) Version