Fix a crash issue when empty strings are set to the BDF properties

[platform/upstream/fontconfig.git] / doc / fclangset.fncs

diff --git a/doc/fclangset.fncs b/doc/fclangset.fncs
index fd1634f..c08d60c 100644 (file)
--- a/doc/fclangset.fncs
+++ b/doc/fclangset.fncs
@@ -62,7 +62,7 @@ two or three letter language from ISO 639 and Tt is a territory from ISO
 @FUNC@         FcLangSetDel
 @TYPE1@                FcLangSet *                     @ARG1@          ls
 @TYPE2@                const FcChar8 *                 @ARG2@          lang
-@PURPOSE@      remove a language from a langset
+@PURPOSE@      delete a language from a langset
 @DESC@
 <parameter>lang</parameter> is removed from <parameter>ls</parameter>.
 <parameter>lang</parameter> should be of the form Ll-Tt where Ll is a
@@ -85,7 +85,7 @@ Returns a set including only those languages found in either <parameter>ls_a</pa
 @TYPE2@                const FcLangSet *               @ARG2@          ls_b
 @PURPOSE@      Subtract langsets
 @DESC@
-Returns a set including only those languages found in <parameter>ls_a</parameter> but not <parameter>ls_b</parameter>.
+Returns a set including only those languages found in <parameter>ls_a</parameter> but not in <parameter>ls_b</parameter>.
 @@
 
 @RET@          FcLangResult
@@ -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