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

3 files changed, 87 insertions, 77 deletions

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>