Bug 473805 – Add API enumerating scripts for a language

2008-08-18  Behdad Esfahbod  <behdad@gnome.org>

        Bug 473805 – Add API enumerating scripts for a language

        * docs/Makefile.am:
        * docs/pango-sections.txt:
        * docs/tmpl/scripts.sgml:
        * docs/tmpl/text-attributes.sgml:
        * docs/tmpl/utils.sgml:
        * pango/pango-language.c (pango_language_get_scripts),
        (pango_language_includes_script),
        (pango_script_get_sample_language):
        * pango/pango-language.h:
        * pango/pango-script.c:
        * pango/pango.def:
        Add a minor new public API:

                pango_language_get_scripts()

        This is what pango_language_includes_script() has been using
        internally.  Previously one had to call that function over all
        possible script values to determine which scripts a language
        uses.  The new API makes that much easier.

svn path=/trunk/; revision=2693

5 files changed, 101 insertions, 90 deletions

diff --git a/docs/Makefile.am b/docs/Makefile.am
index b32cb757..3b5d901b 100644
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -40,7 +40,8 @@ IGNORE_HFILES=			\
 	pangoatsui-private.h	\
 	pangox-private.h	\
 	pangoxft-private.h	\
-	pango-ot-private.h
+	pango-ot-private.h	\
+	pango-script-lang-table.h
 
 # CFLAGS and LDFLAGS for compiling scan program. Only needed
 # if $(DOC_MODULE).types is non-empty.
diff --git a/docs/pango-sections.txt b/docs/pango-sections.txt
index 772e70c5..c5b47c67 100644
--- a/docs/pango-sections.txt
+++ b/docs/pango-sections.txt
@@ -374,11 +374,6 @@ pango_color_parse
 pango_color_copy
 pango_color_free
 pango_color_to_string
-PangoLanguage
-PANGO_TYPE_LANGUAGE
-pango_language_from_string
-pango_language_to_string
-pango_language_matches
 <SUBSECTION>
 PangoAttrList
 PANGO_TYPE_ATTR_LIST
@@ -406,7 +401,6 @@ pango_attr_type_get_type
 pango_attr_list_get_type
 pango_underline_get_type
 pango_color_get_type
-pango_language_get_type
 </SECTION>
 
 <SECTION>
@@ -557,21 +551,29 @@ pango_ellipsize_mode_get_type
 </SECTION>
 
 <SECTION>
-<TITLE>Scripts</TITLE>
+<TITLE>Scripts and Languages</TITLE>
 <FILE>scripts</FILE>
-PangoScriptIter
 PangoScript
 PANGO_TYPE_SCRIPT
+PangoScriptIter
 pango_script_for_unichar
 pango_script_get_sample_language
-pango_language_includes_script
 pango_script_iter_new
 pango_script_iter_get_range
 pango_script_iter_next
 pango_script_iter_free
+PangoLanguage
+PANGO_TYPE_LANGUAGE
+pango_language_from_string
+pango_language_to_string
+pango_language_matches
+pango_language_includes_script
+pango_language_get_scripts
+pango_language_get_default
+pango_language_get_sample_string
 <SUBSECTION Private>
 pango_script_get_type
-PangoScriptForLang
+pango_language_get_type
 </SECTION>
 
 <SECTION>
@@ -1057,8 +1059,6 @@ pango_parse_stretch
 pango_get_sysconf_subdirectory
 pango_get_lib_subdirectory
 pango_log2vis_get_embedding_levels
-pango_language_get_default
-pango_language_get_sample_string
 pango_is_zero_width
 pango_quantize_line_geometry
 </SECTION>
diff --git a/docs/tmpl/scripts.sgml b/docs/tmpl/scripts.sgml
index aa500c90..17aa595e 100644
--- a/docs/tmpl/scripts.sgml
+++ b/docs/tmpl/scripts.sgml
@@ -19,12 +19,6 @@ and of ranges within a larger text string.
 <!-- ##### SECTION Stability_Level ##### -->
 
 
-<!-- ##### STRUCT PangoScriptIter ##### -->
-<para>
-
-</para>
-
-
 <!-- ##### ENUM PangoScript ##### -->
 <para>
 The #PangoScript enumeration identifies different writing
@@ -125,30 +119,26 @@ The #GObject type for #PangoScript
 
 
 
-<!-- ##### FUNCTION pango_script_for_unichar ##### -->
+<!-- ##### STRUCT PangoScriptIter ##### -->
 <para>
 
 </para>
 
-@ch: 
-@Returns: 
-
 
-<!-- ##### FUNCTION pango_script_get_sample_language ##### -->
+<!-- ##### FUNCTION pango_script_for_unichar ##### -->
 <para>
 
 </para>
 
-@script: 
+@ch: 
 @Returns: 
 
 
-<!-- ##### FUNCTION pango_language_includes_script ##### -->
+<!-- ##### FUNCTION pango_script_get_sample_language ##### -->
 <para>
 
 </para>
 
-@language: 
 @script: 
 @Returns: 
 
@@ -191,3 +181,86 @@ The #GObject type for #PangoScript
 @iter: 
 
 
+<!-- ##### STRUCT PangoLanguage ##### -->
+<para>
+The #PangoLanguage structure is used to
+represent a language.
+</para>
+<para>
+#PangoLanguage pointers can be efficiently 
+copied and compared with each other.
+</para>
+
+
+<!-- ##### MACRO PANGO_TYPE_LANGUAGE ##### -->
+<para>
+The #GObject type for #PangoLanguage. 
+</para>
+
+
+
+<!-- ##### FUNCTION pango_language_from_string ##### -->
+<para>
+
+</para>
+
+@language: 
+@Returns: 
+
+
+<!-- ##### FUNCTION pango_language_to_string ##### -->
+<para>
+
+</para>
+
+@language: 
+@Returns: 
+
+
+<!-- ##### FUNCTION pango_language_matches ##### -->
+<para>
+
+</para>
+
+@language: 
+@range_list: 
+@Returns: 
+
+
+<!-- ##### FUNCTION pango_language_includes_script ##### -->
+<para>
+
+</para>
+
+@language: 
+@script: 
+@Returns: 
+
+
+<!-- ##### FUNCTION pango_language_get_scripts ##### -->
+<para>
+
+</para>
+
+@language: 
+@num_scripts: 
+@Returns: 
+
+
+<!-- ##### FUNCTION pango_language_get_default ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
+
+<!-- ##### FUNCTION pango_language_get_sample_string ##### -->
+<para>
+
+</para>
+
+@language: 
+@Returns: 
+
+
diff --git a/docs/tmpl/text-attributes.sgml b/docs/tmpl/text-attributes.sgml
index bbbb5c83..edf2922d 100644
--- a/docs/tmpl/text-attributes.sgml
+++ b/docs/tmpl/text-attributes.sgml
@@ -605,52 +605,6 @@ The #GObject type for #PangoColor.
 @Returns: 
 
 
-<!-- ##### STRUCT PangoLanguage ##### -->
-<para>
-The #PangoLanguage structure is used to
-represent a language.
-</para>
-<para>
-#PangoLanguage pointers can be efficiently 
-copied and compared with each other.
-</para>
-
-
-<!-- ##### MACRO PANGO_TYPE_LANGUAGE ##### -->
-<para>
-The #GObject type for #PangoLanguage. 
-</para>
-
-
-
-<!-- ##### FUNCTION pango_language_from_string ##### -->
-<para>
-
-</para>
-
-@language: 
-@Returns: 
-
-
-<!-- ##### FUNCTION pango_language_to_string ##### -->
-<para>
-
-</para>
-
-@language: 
-@Returns: 
-
-
-<!-- ##### FUNCTION pango_language_matches ##### -->
-<para>
-
-</para>
-
-@language: 
-@range_list: 
-@Returns: 
-
-
 <!-- ##### STRUCT PangoAttrList ##### -->
 <para>
 The #PangoAttrList structure represents a list of attributes
diff --git a/docs/tmpl/utils.sgml b/docs/tmpl/utils.sgml
index f53c776f..6ac6a66f 100644
--- a/docs/tmpl/utils.sgml
+++ b/docs/tmpl/utils.sgml
@@ -188,23 +188,6 @@ backends and modules, but may be useful for other purposes too.
 @Returns: 
 
 
-<!-- ##### FUNCTION pango_language_get_default ##### -->
-<para>
-
-</para>
-
-@Returns: 
-
-
-<!-- ##### FUNCTION pango_language_get_sample_string ##### -->
-<para>
-
-</para>
-
-@language: 
-@Returns: 
-
-
 <!-- ##### FUNCTION pango_is_zero_width ##### -->
 <para>