diff options
Diffstat (limited to 'pango/pango-engine.h')
-rw-r--r-- | pango/pango-engine.h | 61 |
1 files changed, 40 insertions, 21 deletions
diff --git a/pango/pango-engine.h b/pango/pango-engine.h index dc146c00..a06a6e2c 100644 --- a/pango/pango-engine.h +++ b/pango/pango-engine.h @@ -32,15 +32,13 @@ G_BEGIN_DECLS #ifdef PANGO_ENABLE_ENGINE -/* Module API */ - -#include <gmodule.h> - /** * PANGO_RENDER_TYPE_NONE: * * A string constant defining the render type * for engines that are not rendering-system specific. + * + * Deprecated: 1.37 */ #define PANGO_RENDER_TYPE_NONE "PangoRenderNone" @@ -59,6 +57,8 @@ typedef struct _PangoEngineClass PangoEngineClass; * * #PangoEngine is the base class for all types of language and * script specific engines. It has no functionality by itself. + * + * Deprecated: 1.37 **/ struct _PangoEngine { @@ -70,6 +70,8 @@ struct _PangoEngine * PangoEngineClass: * * Class structure for #PangoEngine + * + * Deprecated: 1.37 **/ struct _PangoEngineClass { @@ -84,6 +86,8 @@ GType pango_engine_get_type (void) G_GNUC_CONST; * * A string constant defining the engine type for language engines. * These engines derive from #PangoEngineLang. + * + * Deprecated: 1.37 */ #define PANGO_ENGINE_TYPE_LANG "PangoEngineLang" @@ -105,6 +109,8 @@ typedef struct _PangoEngineLangClass PangoEngineLangClass; * instance, a custom #PangoEngineLang could be provided for * Thai to implement the dictionary-based word boundary * lookups needed for that language. + * + * Deprecated: 1.37 **/ struct _PangoEngineLang { @@ -122,6 +128,8 @@ struct _PangoEngineLang * this is called after that to allow tailoring the breaking results. * * Class structure for #PangoEngineLang + * + * Deprecated: 1.37 **/ struct _PangoEngineLangClass { @@ -144,6 +152,8 @@ GType pango_engine_lang_get_type (void) G_GNUC_CONST; * * A string constant defining the engine type for shaping engines. * These engines derive from #PangoEngineShape. + * + * Deprecated: 1.37 */ #define PANGO_ENGINE_TYPE_SHAPE "PangoEngineShape" @@ -167,6 +177,8 @@ typedef struct _PangoEngineShapeClass PangoEngineShapeClass; * and to a particular script. For instance, there is one * #PangoEngineShape implementation to handle shaping Arabic * for Fontconfig-based backends. + * + * Deprecated: 1.37 **/ struct _PangoEngineShape { @@ -197,6 +209,8 @@ struct _PangoEngineShape * font itself unmodified. * * Class structure for #PangoEngineShape + * + * Deprecated: 1.37 **/ struct _PangoEngineShapeClass { @@ -239,6 +253,8 @@ typedef struct _PangoEngineScriptInfo PangoEngineScriptInfo; * * The #PangoEngineScriptInfo structure contains * information about how the shaper covers a particular script. + * + * Deprecated: 1.37 */ struct _PangoEngineScriptInfo { @@ -256,6 +272,8 @@ struct _PangoEngineScriptInfo * * The #PangoEngineInfo structure contains information about a particular * engine. It contains the following fields: + * + * Deprecated: 1.37 */ struct _PangoEngineInfo { @@ -271,14 +289,11 @@ struct _PangoEngineInfo * @engines: location to store a pointer to an array of engines. * @n_engines: location to store the number of elements in @engines. * - * Function to be provided by a module to list the engines that the - * module supplies. The function stores a pointer to an array - * of #PangoEngineInfo structures and the length of that array in - * the given location. + * Do not use. * - * Note that script_engine_init() will not be called before this - * function. + * Deprecated: 1.37 **/ +G_DEPRECATED void script_engine_list (PangoEngineInfo **engines, int *n_engines); @@ -287,33 +302,33 @@ void script_engine_list (PangoEngineInfo **engines, * @module: a #GTypeModule structure used to associate any * GObject types created in this module with the module. * - * Function to be provided by a module to register any - * GObject types in the module. + * Do not use. + * + * Deprecated: 1.37 **/ +G_DEPRECATED void script_engine_init (GTypeModule *module); /** * script_engine_exit: * - * Function to be provided by the module that is called - * when the module is unloading. Frequently does nothing. + * Do not use. + * + * Deprecated: 1.37 **/ +G_DEPRECATED void script_engine_exit (void); /** * script_engine_create: * @id: the ID of an engine as reported by script_engine_list. * - * Function to be provided by the module to create an instance - * of one of the engines implemented by the module. + * Do not use. * - * Return value: a newly created #PangoEngine of the specified - * type, or %NULL if an error occurred. (In normal operation, - * a module should not return %NULL. A %NULL return is only - * acceptable in the case where system misconfiguration or - * bugs in the driver routine are encountered.) + * Deprecated: 1.37 **/ +G_DEPRECATED PangoEngine *script_engine_create (const char *id); /* Utility macro used by PANGO_ENGINE_LANG_DEFINE_TYPE and @@ -367,6 +382,8 @@ prefix ## _register_type (GTypeModule *module) \ * <informalexample><programlisting> * PangoEngine *engine = g_object_new (<replaceable>prefix</replaceable>_type, NULL); * </programlisting></informalexample> + * + * Deprecated: 1.37 **/ #define PANGO_ENGINE_LANG_DEFINE_TYPE(name, prefix, class_init, instance_init) \ PANGO_ENGINE_DEFINE_TYPE (name, prefix, \ @@ -397,6 +414,8 @@ prefix ## _register_type (GTypeModule *module) \ * <informalexample><programlisting> * PangoEngine *engine = g_object_new (<replaceable>prefix</replaceable>_type, NULL); * </programlisting></informalexample> + * + * Deprecated: 1.37 **/ #define PANGO_ENGINE_SHAPE_DEFINE_TYPE(name, prefix, class_init, instance_init) \ PANGO_ENGINE_DEFINE_TYPE (name, prefix, \ |