From 2b4b35c13a1569da74601a013d8203ba458e2e02 Mon Sep 17 00:00:00 2001 From: Russell Brenner Date: Thu, 8 Mar 2012 10:25:17 -0800 Subject: Add notes about switching languages Fallback and vendor font configuration files now describe how to customize font setup for Han languages (Chinese, Japanese, Korean). Bug: 5873170 Change-Id: Id27cce9a6ba2b6ce61b221342dabdd1b40962933 --- data/fonts/fallback_fonts.xml | 9 +++++++++ data/fonts/vendor_fonts.xml | 9 +++++++++ 2 files changed, 18 insertions(+) (limited to 'data') diff --git a/data/fonts/fallback_fonts.xml b/data/fonts/fallback_fonts.xml index 51b07e4..63b3a58 100644 --- a/data/fonts/fallback_fonts.xml +++ b/data/fonts/fallback_fonts.xml @@ -21,6 +21,15 @@ fallback fonts. That file can also specify the order in which the fallback fonts should be searched, to ensure that a vendor-provided font will be used before another fallback font which happens to handle the same glyph. + + Han languages (Chinese, Japanese, and Korean) share a common range of unicode characters; + their ordering in the fallback or vendor files gives priority to the first in the list. + Locale-specific ordering can be configured by adding language and region codes to the end + of the filename (e.g. /system/etc/fallback_fonts-ja.xml). When no region code is used, + as with this example, all regions are matched. Use separate files for each supported locale. + The standard fallback file (fallback_fonts.xml) is used when a locale does not have its own + file. All fallback files must contain the same complete set of fonts; only their ordering + can differ. --> diff --git a/data/fonts/vendor_fonts.xml b/data/fonts/vendor_fonts.xml index fe51fd2..c1116d0 100644 --- a/data/fonts/vendor_fonts.xml +++ b/data/fonts/vendor_fonts.xml @@ -25,6 +25,15 @@ place in the overall fallback fonts. The order of this list determines which fallback font will be used to support any glyphs that are not handled by the default system fonts. + Han languages (Chinese, Japanese, and Korean) share a common range of unicode characters; + their ordering in the fallback or vendor files gives priority to the first in the list. + Locale-specific ordering can be configured by adding language and region codes to the end + of the filename (e.g. /system/etc/fallback_fonts-ja.xml). When no region code is used, + as with this example, all regions are matched. Use separate files for each supported locale. + The standard fallback file (fallback_fonts.xml) is used when a locale does not have its own + file. All fallback files must contain the same complete set of fonts; only their ordering + can differ. + The sample configuration below is an example of how one might provide two families of fonts that get inserted at the first and second (0 and 1) position in the overall fallback fonts. -- cgit v1.1