Fix a crash issue when empty strings are set to the BDF properties
[platform/upstream/fontconfig.git] / doc / fclangset.fncs
index 8f9678e..c08d60c 100644 (file)
@@ -98,7 +98,7 @@ Returns a set including only those languages found in <parameter>ls_a</parameter
 <parameter>ls_a</parameter> and <parameter>ls_b</parameter>. If they share
 any language and territory pair, this function returns FcLangEqual. If they
 share a language but differ in which territory that language is for, this
-function returns FcLangDiffentTerritory. If they share no languages in
+function returns FcLangDifferentTerritory. If they share no languages in
 common, this function returns FcLangDifferentLang.
 @@
 
@@ -149,11 +149,20 @@ value may not be equal.
 <parameter>ls</parameter> has a matching language and territory pair,
 this function returns FcLangEqual. If <parameter>ls</parameter> has
 a matching language but differs in which territory that language is for, this
-function returns FcLangDiffentTerritory. If <parameter>ls</parameter> 
+function returns FcLangDifferentTerritory. If <parameter>ls</parameter> 
 has no matching language, this function returns FcLangDifferentLang.
 @@
 
 @RET@          FcStrSet *
+@FUNC@         FcGetDefaultLangs
+@TYPE1@                void
+@PURPOSE@      Get the default languages list
+@DESC@
+Returns a string set of the default languages according to the environment variables on the system.
+This function looks for them in order of FC_LANG, LC_ALL, LC_CTYPE and LANG then.
+If there are no valid values in those environment variables, "en" will be set as fallback.
+
+@RET@          FcStrSet *
 @FUNC@         FcLangSetGetLangs
 @TYPE1@                const FcLangSet *               @ARG1@          ls
 @PURPOSE@      get the list of languages in the langset
@@ -169,6 +178,14 @@ Returns a string set of all languages in <parameter>langset</parameter>.
 Returns a string set of all known languages.
 @@
 
+@RET@          FcChar8 *
+@FUNC@         FcLangNormalize
+@TYPE1@                const FcChar8 *                 @ARG1@          lang
+@PURPOSE@      Normalize the language string
+@DESC@
+Returns a string to make <parameter>lang</parameter> suitable on fontconfig.
+@@
+
 @RET@          const FcCharSet *
 @FUNC@         FcLangGetCharSet
 @TYPE1@                const FcChar8 *                 @ARG1@          lang