diff options
Diffstat (limited to 'pango/pango-engine.c')
-rw-r--r-- | pango/pango-engine.c | 39 |
1 files changed, 39 insertions, 0 deletions
diff --git a/pango/pango-engine.c b/pango/pango-engine.c index 04de3df7..6634ff04 100644 --- a/pango/pango-engine.c +++ b/pango/pango-engine.c @@ -19,6 +19,45 @@ * Boston, MA 02111-1307, USA. */ +/** + * SECTION:engines + * @short_description:Language-specific and rendering-system-specific processing + * @title:Engines + * + * Pango utilizes a module architecture in which the language-specific + * and render-system-specific components are provided by loadable + * modules. Each loadable module supplies one or more + * <firstterm>engines</firstterm>. Each <firstterm>engine</firstterm> + * has an associated <firstterm>engine type</firstterm> and + * <firstterm>render type</firstterm>. These two types are represented by strings. + * + * Each dynamically-loaded module exports several functions which provide + * the public API. These functions are script_engine_list(), + * script_engine_init() and script_engine_exit, and + * script_engine_create(). The latter three functions are used when + * creating engines from the module at run time, while the first + * function is used when building a catalog of all available modules. + */ +/** + * SECTION:pango-engine-lang + * @short_description:Rendering-system independent script engines + * @title:PangoEngineLang + * @stability:Unstable + * + * The <firstterm>language engines</firstterm> are rendering-system independent + * engines that determine line, word, and character breaks for character strings. + * These engines are used in pango_break(). + */ +/** + * SECTION:pango-engine-shape + * @short_description:Rendering-system dependent script engines + * @title:PangoEngineShape + * @stability:Unstable + * + * The <firstterm>shape engines</firstterm> are rendering-system dependent + * engines that convert character strings into glyph strings. + * These engines are used in pango_shape(). + */ #include "config.h" #include "pango-engine.h" |