summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorOwen Taylor <otaylor@redhat.com>2003-09-23 23:11:59 +0000
committerOwen Taylor <otaylor@src.gnome.org>2003-09-23 23:11:59 +0000
commit0f36f55ee0e7c9bf224fabbaf31843b3868f213c (patch)
treea8446856f4dce9b792f5e2ca1c3f9d25bbc40b76 /docs
parent8fa8e29cd61c802c6b100b3cca800784e3a9de20 (diff)
downloadpango-0f36f55ee0e7c9bf224fabbaf31843b3868f213c.tar.gz
Modules now declare a list of scripts that they cover instead of a list of
Tue Sep 23 18:03:57 2003 Owen Taylor <otaylor@redhat.com> * pango/pango-engines.[ch] pango/pango-engines-private.h: Modules now declare a list of scripts that they cover instead of a list of code point ranges. Also, there is now a ->covers() virtual function that allows a module to decide live whether the font covers a particular codepoint; remove old get_coverage() method. * pango/pango-fontset.[ch]: Add a foreach() function to iterate over all the fonts in a fontset (with a true return stopping iteration). * pango/pango-context.c: Complete rewrite using script-run information to improve language tags. Switch to an approach where we handle one run at a time rather than computing information for each character individually then later breaking the result into runs. * pango/pango-fontset.[ch]: Switch over to using pango-impl-utils.h. * modules/basic/basic-x.c pango/pangox-fontmap.c: Adapt to the change from get_coverage => covers. * pango/pango-modules.h pango/modules.c: Switch PangoMap over to being based on script rather than being based on codepoint. Remove the no longer needed pango_map_get_entry(). * pango/modules.c: Handle new script-based modules. * pango/pango-fc-fontmap.c pango/pango-win32-fontmap.c pango/pang-fontmap.[ch]: Add a shape_engine_type field to PangoFontmapClass, pango_font_map_get_shape_engine_type(); this allows generic code to find a shaper for a particular fontmap. * pango/pango-script.[ch]: Add pango_script_get_sample_language(), pango_language_includes_script(); functions for determining the relationship between scripts and language. * tools/gen-script-for-lang.c: Modify to spit out a useful table. * pango/pango-script-lang-table.h: Version of table generated from current fontconfig data. * pango/pangox.c: Remove complicated code to compute coverages; no longer useful now that we just have the basic shaper as a legacy thing. * modules/*/*.c: Adapt to identifying shape engines by language range. * modules/thai/thai-fc.c modules/thai/thai-shaper.[ch]: Remove now unused "has_glyph" function and XTIS support. * modules/thai/thai-fc.c: Handle non-Thai characters as well, since the Thai module now gets spaces, punctuation, and so forth.
Diffstat (limited to 'docs')
-rw-r--r--docs/pango-sections.txt2
-rw-r--r--docs/tmpl/engines.sgml21
-rw-r--r--docs/tmpl/fonts.sgml2
-rw-r--r--docs/tmpl/modules.sgml16
-rw-r--r--docs/tmpl/pango-engine-shape.sgml1
5 files changed, 16 insertions, 26 deletions
diff --git a/docs/pango-sections.txt b/docs/pango-sections.txt
index d1306e0b..22ea5f4f 100644
--- a/docs/pango-sections.txt
+++ b/docs/pango-sections.txt
@@ -468,7 +468,7 @@ pango_script_get_type
<TITLE>Engines</TITLE>
<FILE>engines</FILE>
PangoEngineInfo
-PangoEngineRange
+PangoEngineScriptInfo
PangoEngine
PangoEngineClass
PANGO_RENDER_TYPE_NONE
diff --git a/docs/tmpl/engines.sgml b/docs/tmpl/engines.sgml
index 754540ce..fb7fdfd2 100644
--- a/docs/tmpl/engines.sgml
+++ b/docs/tmpl/engines.sgml
@@ -37,23 +37,20 @@ engine. It contains the following fields:
@id: a unique string ID for the engine.
@engine_type: a string identifying the engine type.
@render_type: a string identifying the render type.
-@ranges: a pointer to an array of #PangoEngineRange
- structures. Each structure contains information
- about a range of Unicode code points that
- this engine handles.
-@n_ranges: the number of elements in <structfield>ranges</structfield>.
+@scripts:
+@n_scripts:
-<!-- ##### STRUCT PangoEngineRange ##### -->
+<!-- ##### STRUCT PangoEngineScriptInfo ##### -->
<para>
-The PangoEngineRange structure contains
-information about a range of Unicode code
-points. It contains the following fields:
+The PangoEngineScriptInfo structure contains
+information about how the shaper covers a particular
+script.
</para>
-@start: the first code point in the range.
-@end: the last code point for the range.
+@script: a #PangoScript. The value %PANGO_SCRIPT_COMMON has
+ the special meaning here of "all scripts"
@langs: a semicolon separated list of languages that this
- engine handles for this range. This may be empty,
+ engine handles for this script. This may be empty,
in which case the engine is saying that it is a
fallback choice for all languages for this range,
but should not be used if another engine
diff --git a/docs/tmpl/fonts.sgml b/docs/tmpl/fonts.sgml
index e5385006..6d134866 100644
--- a/docs/tmpl/fonts.sgml
+++ b/docs/tmpl/fonts.sgml
@@ -697,6 +697,7 @@ a particular #PangoFontMap implementation.
@list_families: A function to list available font families. See
pango_font_map_list_families().
@load_fontset:
+@shape_engine_type:
<!-- ##### MACRO PANGO_FONT_MAP_CLASS ##### -->
<para>
@@ -785,6 +786,7 @@ a particular #PangoFontset implementation.
@get_metrics: a function to get overall metric information for the fonts
in the fontset; see pango_fontset_get_metrics().
@get_language: a function to get the language of the fontset.
+@foreach:
<!-- ##### FUNCTION pango_fontset_get_font ##### -->
<para>
diff --git a/docs/tmpl/modules.sgml b/docs/tmpl/modules.sgml
index 32172efd..893fffe5 100644
--- a/docs/tmpl/modules.sgml
+++ b/docs/tmpl/modules.sgml
@@ -40,8 +40,6 @@ for the codepoint to which this entry belongs and also whether the engine
matches the language tag for this entry's map exactly or just approximately.
</para>
-@info:
-@is_exact:
<!-- ##### FUNCTION pango_find_map ##### -->
<para>
@@ -54,24 +52,16 @@ matches the language tag for this entry's map exactly or just approximately.
@Returns:
-<!-- ##### FUNCTION pango_map_get_entry ##### -->
-<para>
-
-</para>
-
-@map:
-@wc:
-@Returns:
-
-
<!-- ##### FUNCTION pango_map_get_engine ##### -->
<para>
</para>
@map:
-@wc:
+@script:
@Returns:
+<!-- # Unused Parameters # -->
+@wc:
<!-- ##### FUNCTION pango_module_register ##### -->
diff --git a/docs/tmpl/pango-engine-shape.sgml b/docs/tmpl/pango-engine-shape.sgml
index 2e0f91ce..68c37707 100644
--- a/docs/tmpl/pango-engine-shape.sgml
+++ b/docs/tmpl/pango-engine-shape.sgml
@@ -26,6 +26,7 @@ Rendering-system dependent script engines
@script_shape:
@get_coverage:
+@covers:
<!-- ##### MACRO PANGO_ENGINE_TYPE_SHAPE ##### -->
<para>