summaryrefslogtreecommitdiff
path: root/doc/fontconfig-user.sgml
Commit message (Collapse)AuthorAgeFilesLines
* Add missing property descriptionsHEADmainAkira TAGOH2023-05-171-0/+4
| | | | Fixes https://gitlab.freedesktop.org/fontconfig/fontconfig/-/issues/360
* Change the order of the properties to the order of fontconfig cache formatAkira TAGOH2023-05-171-7/+7
|
* Adujst indentation between programlisting in fontconfig-user.sgmlAkira TAGOH2023-01-271-275/+315
| | | | Fixes https://gitlab.freedesktop.org/fontconfig/fontconfig/-/issues/344
* Expand ~ in globOndrej Balaz2023-01-251-1/+2
| | | | | | Allow ~ home directory expansion in acceptfont and rejectfont globs. Fixes: #347
* Convert tabs to spacesAkira TAGOH2022-12-131-98/+98
| | | | | | This fixes broken layout on pdf. Fixes https://gitlab.freedesktop.org/fontconfig/fontconfig/-/issues/343
* Bump the cache version to 8 in doc/fontconfig-user.sgmlAlan Coopersmith2022-04-121-1/+1
| | | | | | Makes docs match code changes from commit 5d84745e7209d4c6 Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* Fix closing tag bracket typo in doc/fontconfig-user.sgmlratijas2020-12-171-1/+1
|
* Add FC_ORDER property into cacheAkira TAGOH2020-05-251-0/+1
| | | | | | | | | | "fontversion" used to be modified to sort out fonts as a technique. But that lost the original purpose to do the version control between releases. This change adds the dedicated property into the cache. Fixes https://gitlab.freedesktop.org/fontconfig/fontconfig/-/issues/226
* Use an URN for DTD IDNicolas Mailhot2020-03-281-3/+3
| | | | | | | | | | | | | | | | | | | | | XML tools interpret “fonts.dtd” as a relative path. Unfortunately, that can not work now that the configuration is spread over multiple system-dependant directories, without a common relative path to this file. And, an absolute path can not be defined in a system-independant way. System independance is a requirement to share config files between systems. Therefore, replace the broken relative path by a formal URN, that will work the same way on all systems, without network access. This makes the DTD registerable with commands like: $ xmlcatalog --noout --add system \ "urn:fontconfig:fonts.dtd" \ "file:///usr/share/xml/fontconfig/fonts.dtd" \ /etc/xml/catalog That enables easy config file checking: $ xmllint --loaddtd ${config_file} >/dev/null
* Add FC_FONT_HAS_HINT property to see if font has hinting or not.Akira TAGOH2019-07-291-0/+1
| | | | This may helps to enable autohint only when font doesn't have any hinting
* Update doc for saltAkira TAGOH2019-04-031-3/+9
|
* Add reset-dirs elementAkira TAGOH2019-04-031-0/+4
| | | | | | This element removes all of fonts directories where added by dir elements. it is useful to override fonts dirs from system to their own dirs only.
* Add new element remap-dir instead of extending dir elementAkira TAGOH2019-04-031-7/+8
|
* Replace UUID file mechanism with per-directory 'map' attribute [v2]Keith Packard2019-04-031-1/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The UUID files would be placed in each font directory to provide the unique cache name, independent of path, for that directory. The UUID files are undesireable for a couple of reasons: 1) They must be placed in the font directories to be useful. This requires modifying the font directories themselves, introducing potential visible timestamp changes when running multiple applications, and makes the cache processing inconsistent between applications with permission to write to the font directories and applications without such permission. 2) The UUID contents were generated randomly, which makes the font cache not reproducible across multiple runs. One proposed fix for 2) is to make the UUID dependent on the font directory path, but once we do that, we can simply use the font directory path itself as the key as the original MD5-based font cache naming mechanism did. The goal of the UUID file mechanism was to fix startup time of flatpaks; as the font path names inside the flatpak did not match the font path names in the base system, the font cache would need to be reconstructed the first time the flatpak was launched. The new mechanism for doing this is to allow each '<dir>' element in the configuration include a 'map' attribute. When looking for a cache file for a particular directory, if the directory name starts with the contents of the <dir> element, that portion of the name will be replaced with the value of the 'map' attribute. Outside of the flatpak, nothing need change -- fontconfig will build cache files using real directory names. Inside the flatpak, the custom fonts.conf file will now include mappings such as this: <dir map="/usr/share/fonts">/run/host/fonts</dir> When scanning the directory /run/host/fonts/ttf, fontconfig will use the name /usr/share/fonts/ttf as the source for building the cache file name. The existing FC_FILE replacement code used for the UUID-based implementation continues to correctly adapt font path names seen by applications. v2: Leave FcDirCacheCreateUUID stub around to avoid removing public API function. Document 'map' attribute of <dir> element in fontconfig-user.sgml Suggested-by: Akira TAGOH <akira@tagoh.org> Signed-off-by: Keith Packard <keithp@keithp.com>
* Add doc for description element and update fonts.dtdAkira TAGOH2018-11-151-0/+5
| | | | Fixes https://gitlab.freedesktop.org/fontconfig/fontconfig/issues/133
* Update docs for 1aa8b700Akira TAGOH2018-10-041-1/+1
|
* Ensure cache checksums are deterministicChris Lamb2018-05-161-1/+5
| | | | | | | | | | | | | | | | | | | | | | | | Whilst working on the Reproducible Builds[0] effort, we noticed that fontconfig generates unreproducible cache files. This is due to fc-cache uses the modification timestamps of each directory in the "checksum" and "checksum_nano" members of the _FcCache struct. This is so that it can identify which cache files are valid and/or require regeneration. This patch changes the behaviour of the checksum calculations to prefer the value of the SOURCE_DATE_EPOCH[1] environment variable over the directory's own mtime. This variable can then be exported by build systems to ensure reproducible output. If SOURCE_DATE_EPOCH is not set or is newer than the mtime of the directory, the existing behaviour is unchanged. This work was sponsored by Tails[2]. [0] https://reproducible-builds.org/ [1] https://reproducible-builds.org/specs/source-date-epoch/ [2] https://tails.boum.org/
* Add FONTCONFIG_SYSROOT environment variableTom Anderson2018-05-051-0/+4
|
* Fix typo in docAkira TAGOH2018-04-191-5/+5
| | | | https://bugs.freedesktop.org/show_bug.cgi?id=106128
* Add the description of FC_LANG envvar to the docAkira TAGOH2017-03-241-0/+4
|
* Correct cache version info in doc/fontconfig-user.sgmlAlan Coopersmith2016-08-151-2/+2
| | | | Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* Add one more debugging option to see transformation on font-matchingAkira TAGOH2015-06-081-1/+5
| | | | | | | | | | | just setting FC_MATCH=3 shows a lot of information and hard to keep on track for informamtion which is really necessary to see. to use this more effectively, added FC_DBG_MATCH_FILTER to see for what one really want to see. it takes a comma-separated-list of object names. If you want to see family name only, try like this: FC_DBG_MATCH_FILTER=family FC_DEBUG=4096 fc-match debugging output will be filtered out and see family only in the result.
* Make FC_SCALE deprecatedAkira TAGOH2015-05-121-1/+1
| | | | | | Use FC_MATRIX instead. https://bugs.freedesktop.org/show_bug.cgi?id=90257
* Fix a typo in fontconfig-user.sgmlAkira TAGOH2015-04-221-1/+1
| | | | https://bugs.freedesktop.org/show_bug.cgi?id=90105
* Fix a typo for the latest cache versionAkira TAGOH2015-04-201-1/+1
|
* Fix a typo in docsAkira TAGOH2015-01-191-1/+1
|
* Add missing docsAkira TAGOH2015-01-061-0/+7
|
* Change DemiLight from 65 to 55Behdad Esfahbod2014-07-251-2/+2
| | | | Such that Regular is closer to Medium than to DemiLight
* Add FC_WEIGHT_DEMILIGHTBehdad Esfahbod2014-07-251-0/+2
| | | | | Part of https://bugs.freedesktop.org/show_bug.cgi?id=81453 Also hooks up FC_WEIGHT_BOOK to fcfreetype.c.
* Bug 68955 - Deprecate / remove FC_RASTERIZERAkira TAGOH2013-09-101-1/+1
|
* Bug 23757 - Add mode="delete" to <edit>Akira TAGOH2013-02-011-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add two edit mode, "delete" and "delete_all". what values are being deleted depends on <test> as documented. if the target object is same to what is tested, matching value there will be deleted. otherwise all of values in the object will be deleted. so this would means both edit mode will not take any expressions. e.g. Given that the testing is always true here, the following rules: <match> <test name="foo" compare="eq"> <string>bar</string> </test> <edit name="foo" mode="delete"/> </match> will removes "bar" string from "foo" object. and: <match> <test name="foo" compare="eq"> <string>foo</string> </test> <edit name="bar" mode="delete"/> </match> will removes all of values in "bar" object.
* Bug 59379 - FC_PRGNAMEBehdad Esfahbod2013-01-151-0/+1
| | | | Can be used for per-application configuration.
* Bug 50497 - RFE: Add OpenType feature tags supportAkira TAGOH2013-01-151-0/+1
| | | | Add FC_FONT_FEATURES to store the feature tags to be enabled.
* Adjust docs for recent changesBehdad Esfahbod2012-12-311-3/+9
|
* Bug 18726 - RFE: help write locale-specific testsAkira TAGOH2012-06-221-0/+35
| | | | Add an example matching rule for the language specific
* Bug 50835 - Deprecate FC_GLOBAL_ADVANCEAkira TAGOH2012-06-111-1/+1
| | | | | FC_GLOBAL_ADVANCE is deprecated. this flag is simply ignored on freetype 2.4.5 or later.
* Bug 33644 - Fontconfig doesn't match correctly in <test>Akira TAGOH2012-05-251-0/+23
| | | | | | | | | Warn if the multiple values is set to <test>, including the case of in <alias> because the behavior isn't intuitive since so many users is asking for a help to get things working for their expectation. Use multiple <match>s or <alias>es for OR operator and multiple <test>s for AND operator.
* Correct the exampleAkira TAGOH2012-05-211-5/+5
| | | | Enclose the string with <string> in <test>
* Bug 20411 - fontconfig doesn't match FreeDesktop directories specsAkira TAGOH2012-05-181-17/+20
| | | | | | | | Allows reading configuration files, fonts and cache files from the directories where the XDG Base Directory Specification defines. the old directories are still in the configuration files for the backward compatibility.
* Bug 19128 - Handling whitespace in aliasesAkira TAGOH2012-05-141-1/+2
| | | | | | | | Add a new attribute `ignore-blanks' to <test>. When this is set to "true", any blanks in the string will be ignored on comparison. This takes effects for compare="eq" or "not_eq" only. Also changed the behavior of the comparison on <alias> too.
* Bug 39278 - make usage of mmap optionalAkira TAGOH2012-04-251-1/+19
| | | | | | | Stop using mmap() if the cache file is stored on NFS. also added FONTCONFIG_USE_MMAP environment variable to enforce the use of or not the use of mmap(2) regardless of what the filesystem the cache files are stored on.
* doc: Add contains and not_contains operators and elementsAkira TAGOH2012-03-301-3/+3
|
* [doc] Update for cachedir.Akira TAGOH2012-03-121-9/+10
| | | | | <cache> element is now obsoletes and no longer used. get rid of it from the doc and add <cachedir> instead.
* [doc] Update the path for cache files and the version.Akira TAGOH2012-03-121-3/+3
|
* Documentation fixesBrad Hards2011-03-111-4/+4
|
* add some documentsAkira TAGOH2010-12-091-0/+4
|
* add some document for range and charset.Akira TAGOH2010-12-091-0/+8
|
* Cleanup copyright notices to replace "Keith Packard" with "the author(s)"Behdad Esfahbod2010-11-101-2/+2
|
* [doc] Add ~/fonts.conf.d to user docsBehdad Esfahbod2009-07-271-0/+7
|
* Replace 'KEITH PACKARD' with 'THE AUTHOR(S)' in license text in all filesBehdad Esfahbod2009-03-131-2/+2
|