pango 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32

data/vendor/local/include/pango-1.0/pango/pango-modules.h

@@ -33,6 +33,17 @@ typedef struct _PangoMapEntry PangoMapEntry;
 
 typedef struct _PangoIncludedModule PangoIncludedModule;
 
+/**
+ * PangoIncludedModule:
+ * @list: a function that lists the engines defined in this module.
+ * @init: a function to initialize the module.
+ * @exit: a function to finalize the module.
+ * @create: a function to create an engine, given the engine name.
+ *
+ * The #PangoIncludedModule structure for a statically linked module
+ * contains the functions that would otherwise be loaded from a dynamically
+ * loaded module.
+ */
 struct _PangoIncludedModule
 {
   void (*list) (PangoEngineInfo **engines,

data/vendor/local/include/pango-1.0/pango/pango-ot.h

@@ -34,8 +34,35 @@ G_BEGIN_DECLS
 
 #ifdef PANGO_ENABLE_ENGINE
 
+/**
+ * PangoOTTag:
+ *
+ * The #PangoOTTag typedef is used to represent TrueType and OpenType
+ * four letter tags inside Pango. Use PANGO_OT_TAG_MAKE()
+ * or PANGO_OT_TAG_MAKE_FROM_STRING() macros to create <type>PangoOTTag</type>s manually.
+ */
 typedef guint32 PangoOTTag;
 
+/**
+ * PANGO_OT_TAG_MAKE:
+ * @c1: First character.
+ * @c2: Second character.
+ * @c3: Third character.
+ * @c4: Fourth character.
+ *
+ * Creates a #PangoOTTag from four characters.  This is similar and
+ * compatible with the <function>FT_MAKE_TAG()</function> macro from FreeType.
+ */
+/**
+ * PANGO_OT_TAG_MAKE_FROM_STRING:
+ * @s: The string representation of the tag.
+ *
+ * Creates a #PangoOTTag from a string. The string should be at least
+ * four characters long (pad with space characters if needed), and need
+ * not be nul-terminated.  This is a convenience wrapper around
+ * PANGO_OT_TAG_MAKE(), but cannot be used in certain situations, for
+ * example, as a switch expression, as it dereferences pointers.
+ */
 #define PANGO_OT_TAG_MAKE(c1,c2,c3,c4)		((PangoOTTag) FT_MAKE_TAG (c1, c2, c3, c4))
 #define PANGO_OT_TAG_MAKE_FROM_STRING(s)	(PANGO_OT_TAG_MAKE(((const char *) s)[0], \
 								   ((const char *) s)[1], \
@@ -49,21 +76,109 @@ typedef struct _PangoOTRuleset    PangoOTRuleset;
 typedef struct _PangoOTFeatureMap PangoOTFeatureMap;
 typedef struct _PangoOTRulesetDescription PangoOTRulesetDescription;
 
+/**
+ * PangoOTTableType:
+ * @PANGO_OT_TABLE_GSUB: The GSUB table.
+ * @PANGO_OT_TABLE_GPOS: The GPOS table.
+ *
+ * The <type>PangoOTTableType</type> enumeration values are used to
+ * identify the various OpenType tables in the
+ * <function>pango_ot_info_*</function> functions.
+ */
 typedef enum
 {
   PANGO_OT_TABLE_GSUB,
   PANGO_OT_TABLE_GPOS
 } PangoOTTableType;
 
+/**
+ * PANGO_OT_ALL_GLYPHS:
+ *
+ * This is used as the property bit in pango_ot_ruleset_add_feature() when a
+ * feature should be applied to all glyphs.
+ *
+ * Since: 1.16
+ */
+/**
+ * PANGO_OT_NO_FEATURE:
+ *
+ * This is used as a feature index that represent no feature, that is, should be
+ * skipped.  It may be returned as feature index by pango_ot_info_find_feature()
+ * if the feature is not found, and pango_ot_ruleset_add_feature() function
+ * automatically skips this value, so no special handling is required by the user.
+ *
+ * Since: 1.18
+ */
+/**
+ * PANGO_OT_NO_SCRIPT:
+ *
+ * This is used as a script index that represent no script, that is, when the
+ * requested script was not found, and a default ('DFLT') script was not found
+ * either.  It may be returned as script index by pango_ot_info_find_script()
+ * if the script or a default script are not found, all other functions
+ * taking a script index essentially return if the input script index is
+ * this value, so no special handling is required by the user.
+ *
+ * Since: 1.18
+ */
+/**
+ * PANGO_OT_DEFAULT_LANGUAGE:
+ *
+ * This is used as the language index in pango_ot_info_find_feature() when
+ * the default language system of the script is desired.
+ *
+ * It is also returned by pango_ot_info_find_language() if the requested language
+ * is not found, or the requested language tag was PANGO_OT_TAG_DEFAULT_LANGUAGE.
+ * The end result is that one can always call pango_ot_tag_from_language()
+ * followed by pango_ot_info_find_language() and pass the result to
+ * pango_ot_info_find_feature() without having to worry about falling back to
+ * default language system explicitly.
+ *
+ * Since: 1.16
+ */
 #define PANGO_OT_ALL_GLYPHS			((guint) 0xFFFF)
 #define PANGO_OT_NO_FEATURE			((guint) 0xFFFF)
 #define PANGO_OT_NO_SCRIPT			((guint) 0xFFFF)
 #define PANGO_OT_DEFAULT_LANGUAGE		((guint) 0xFFFF)
 
+/**
+ * PANGO_OT_TAG_DEFAULT_SCRIPT:
+ *
+ * This is a #PangoOTTag representing the special script tag 'DFLT'.  It is
+ * returned as script tag by pango_ot_tag_from_script() if the requested script
+ * is not found.
+ *
+ * Since: 1.18
+ */
+/**
+ * PANGO_OT_TAG_DEFAULT_LANGUAGE:
+ *
+ * This is a #PangoOTTag representing a special language tag 'dflt'.  It is
+ * returned as language tag by pango_ot_tag_from_language() if the requested
+ * language is not found.  It is safe to pass this value to
+ * pango_ot_info_find_language() as that function falls back to returning default
+ * language-system if the requested language tag is not found.
+ *
+ * Since: 1.18
+ */
 #define PANGO_OT_TAG_DEFAULT_SCRIPT		PANGO_OT_TAG_MAKE ('D', 'F', 'L', 'T')
 #define PANGO_OT_TAG_DEFAULT_LANGUAGE		PANGO_OT_TAG_MAKE ('d', 'f', 'l', 't')
 
 /* Note that this must match hb_glyph_info_t */
+/**
+ * PangoOTGlyph:
+ * @glyph: the glyph itself.
+ * @properties: the properties value, identifying which features should be
+ * applied on this glyph.  See pango_ot_ruleset_add_feature().
+ * @cluster: the cluster that this glyph belongs to.
+ * @component: a component value, set by the OpenType layout engine.
+ * @ligID: a ligature index value, set by the OpenType layout engine.
+ * @internal: for Pango internal use
+ *
+ * The #PangoOTGlyph structure represents a single glyph together with
+ * information used for OpenType layout processing of the glyph.
+ * It contains the following fields.
+ */
 struct _PangoOTGlyph
 {
   guint32  glyph;
@@ -75,12 +190,46 @@ struct _PangoOTGlyph
   guint    internal;
 };
 
+/**
+ * PangoOTFeatureMap:
+ * @feature_name: feature tag in represented as four-letter ASCII string.
+ * @property_bit: the property bit to use for this feature.  See
+ * pango_ot_ruleset_add_feature() for details.
+ *
+ * The #PangoOTFeatureMap typedef is used to represent an OpenType
+ * feature with the property bit associated with it.  The feature tag is
+ * represented as a char array instead of a #PangoOTTag for convenience.
+ *
+ * Since: 1.18
+ */
 struct _PangoOTFeatureMap
 {
   char     feature_name[5];
   gulong   property_bit;
 };
 
+/**
+ * PangoOTRulesetDescription:
+ * @script: a #PangoScript.
+ * @language: a #PangoLanguage.
+ * @static_gsub_features: static map of GSUB features, or %NULL.
+ * @n_static_gsub_features: length of @static_gsub_features, or 0.
+ * @static_gpos_features: static map of GPOS features, or %NULL.
+ * @n_static_gpos_features: length of @static_gpos_features, or 0.
+ * @other_features: map of extra features to add to both GSUB and GPOS, or %NULL.
+ * Unlike the static maps, this pointer need not live beyond
+ * the life of function calls taking this struct.
+ * @n_other_features: length of @other_features, or 0.
+ *
+ * The #PangoOTRuleset structure holds all the information needed
+ * to build a complete #PangoOTRuleset from an OpenType font.
+ * The main use of this struct is to act as the key for a per-font
+ * hash of rulesets.  The user populates a ruleset description and
+ * gets the ruleset using pango_ot_ruleset_get_for_description()
+ * or create a new one using pango_ot_ruleset_new_from_description().
+ *
+ * Since: 1.18
+ */
 struct _PangoOTRulesetDescription {
   PangoScript               script;
   PangoLanguage            *language;

data/vendor/local/include/pango-1.0/pango/pango-script.h

@@ -34,6 +34,108 @@ G_BEGIN_DECLS
  **/
 typedef struct _PangoScriptIter PangoScriptIter;
 
+/**
+ * PangoScript:
+ * @PANGO_SCRIPT_INVALID_CODE: a value never returned from pango_script_for_unichar()
+ * @PANGO_SCRIPT_COMMON: a character used by multiple different scripts
+ * @PANGO_SCRIPT_INHERITED: a mark glyph that takes its script from the
+ * base glyph to which it is attached
+ * @PANGO_SCRIPT_ARABIC: 	Arabic
+ * @PANGO_SCRIPT_ARMENIAN: Armenian
+ * @PANGO_SCRIPT_BENGALI: 	Bengali
+ * @PANGO_SCRIPT_BOPOMOFO: Bopomofo
+ * @PANGO_SCRIPT_CHEROKEE: 	Cherokee
+ * @PANGO_SCRIPT_COPTIC: 	Coptic
+ * @PANGO_SCRIPT_CYRILLIC: 	Cyrillic
+ * @PANGO_SCRIPT_DESERET: 	Deseret
+ * @PANGO_SCRIPT_DEVANAGARI: 	Devanagari
+ * @PANGO_SCRIPT_ETHIOPIC: 	Ethiopic
+ * @PANGO_SCRIPT_GEORGIAN: 	Georgian
+ * @PANGO_SCRIPT_GOTHIC: 	Gothic
+ * @PANGO_SCRIPT_GREEK: 	Greek
+ * @PANGO_SCRIPT_GUJARATI: 	Gujarati
+ * @PANGO_SCRIPT_GURMUKHI: 	Gurmukhi
+ * @PANGO_SCRIPT_HAN: 	Han
+ * @PANGO_SCRIPT_HANGUL: 	Hangul
+ * @PANGO_SCRIPT_HEBREW: 	Hebrew
+ * @PANGO_SCRIPT_HIRAGANA: 	Hiragana
+ * @PANGO_SCRIPT_KANNADA: 	Kannada
+ * @PANGO_SCRIPT_KATAKANA: 	Katakana
+ * @PANGO_SCRIPT_KHMER: 	Khmer
+ * @PANGO_SCRIPT_LAO: 	Lao
+ * @PANGO_SCRIPT_LATIN: 	Latin
+ * @PANGO_SCRIPT_MALAYALAM: 	Malayalam
+ * @PANGO_SCRIPT_MONGOLIAN: 	Mongolian
+ * @PANGO_SCRIPT_MYANMAR: 	Myanmar
+ * @PANGO_SCRIPT_OGHAM: 	Ogham
+ * @PANGO_SCRIPT_OLD_ITALIC: 	Old Italic
+ * @PANGO_SCRIPT_ORIYA: 	Oriya
+ * @PANGO_SCRIPT_RUNIC: 	Runic
+ * @PANGO_SCRIPT_SINHALA: 	Sinhala
+ * @PANGO_SCRIPT_SYRIAC: 	Syriac
+ * @PANGO_SCRIPT_TAMIL: 	Tamil
+ * @PANGO_SCRIPT_TELUGU: 	Telugu
+ * @PANGO_SCRIPT_THAANA: 	Thaana
+ * @PANGO_SCRIPT_THAI: 	Thai
+ * @PANGO_SCRIPT_TIBETAN: 	Tibetan
+ * @PANGO_SCRIPT_CANADIAN_ABORIGINAL: 	Canadian Aboriginal
+ * @PANGO_SCRIPT_YI: 	Yi
+ * @PANGO_SCRIPT_TAGALOG: 	Tagalog
+ * @PANGO_SCRIPT_HANUNOO: 	Hanunoo
+ * @PANGO_SCRIPT_BUHID: 	Buhid
+ * @PANGO_SCRIPT_TAGBANWA: 	Tagbanwa
+ * @PANGO_SCRIPT_BRAILLE: 	Braille
+ * @PANGO_SCRIPT_CYPRIOT: 	Cypriot
+ * @PANGO_SCRIPT_LIMBU: 	Limbu
+ * @PANGO_SCRIPT_OSMANYA: 	Osmanya
+ * @PANGO_SCRIPT_SHAVIAN: 	Shavian
+ * @PANGO_SCRIPT_LINEAR_B: 	Linear B
+ * @PANGO_SCRIPT_TAI_LE: 	Tai Le
+ * @PANGO_SCRIPT_UGARITIC: 	Ugaritic
+ * @PANGO_SCRIPT_NEW_TAI_LUE: 	New Tai Lue. Since 1.10
+ * @PANGO_SCRIPT_BUGINESE: 	Buginese. Since 1.10
+ * @PANGO_SCRIPT_GLAGOLITIC: 	Glagolitic. Since 1.10
+ * @PANGO_SCRIPT_TIFINAGH: 	Tifinagh. Since 1.10
+ * @PANGO_SCRIPT_SYLOTI_NAGRI: 	Syloti Nagri. Since 1.10
+ * @PANGO_SCRIPT_OLD_PERSIAN: 	Old Persian. Since 1.10
+ * @PANGO_SCRIPT_KHAROSHTHI: 	Kharoshthi. Since 1.10
+ * @PANGO_SCRIPT_UNKNOWN: 		an unassigned code point. Since 1.14
+ * @PANGO_SCRIPT_BALINESE: 		Balinese. Since 1.14
+ * @PANGO_SCRIPT_CUNEIFORM: 	Cuneiform. Since 1.14
+ * @PANGO_SCRIPT_PHOENICIAN: 	Phoenician. Since 1.14
+ * @PANGO_SCRIPT_PHAGS_PA: 		Phags-pa. Since 1.14
+ * @PANGO_SCRIPT_NKO: 		N'Ko. Since 1.14
+ * @PANGO_SCRIPT_KAYAH_LI:   Kayah Li. Since 1.20.1
+ * @PANGO_SCRIPT_LEPCHA:     Lepcha. Since 1.20.1
+ * @PANGO_SCRIPT_REJANG:     Rejang. Since 1.20.1
+ * @PANGO_SCRIPT_SUNDANESE:  Sundanese. Since 1.20.1
+ * @PANGO_SCRIPT_SAURASHTRA: Saurashtra. Since 1.20.1
+ * @PANGO_SCRIPT_CHAM:       Cham. Since 1.20.1
+ * @PANGO_SCRIPT_OL_CHIKI:   Ol Chiki. Since 1.20.1
+ * @PANGO_SCRIPT_VAI:        Vai. Since 1.20.1
+ * @PANGO_SCRIPT_CARIAN:     Carian. Since 1.20.1
+ * @PANGO_SCRIPT_LYCIAN:     Lycian. Since 1.20.1
+ * @PANGO_SCRIPT_LYDIAN:     Lydian. Since 1.20.1
+ * @PANGO_SCRIPT_BATAK:      Batak. Since 1.32
+ * @PANGO_SCRIPT_BRAHMI:     Brahmi. Since 1.32
+ * @PANGO_SCRIPT_MANDAIC:    Mandaic. Since 1.32
+ * @PANGO_SCRIPT_CHAKMA:               Chakma. Since: 1.32
+ * @PANGO_SCRIPT_MEROITIC_CURSIVE:     Meroitic Cursive. Since: 1.32
+ * @PANGO_SCRIPT_MEROITIC_HIEROGLYPHS: Meroitic Hieroglyphs. Since: 1.32
+ * @PANGO_SCRIPT_MIAO:                 Miao. Since: 1.32
+ * @PANGO_SCRIPT_SHARADA:              Sharada. Since: 1.32
+ * @PANGO_SCRIPT_SORA_SOMPENG:         Sora Sompeng. Since: 1.32
+ * @PANGO_SCRIPT_TAKRI:                Takri. Since: 1.32
+ *
+ * The #PangoScript enumeration identifies different writing
+ * systems. The values correspond to the names as defined in the
+ * Unicode standard.
+ * Note that new types may be added in the future. Applications should be ready
+ * to handle unknown values.  This enumeration is interchangeable with
+ * #GUnicodeScript.  See <ulink
+ * url="http://www.unicode.org/reports/tr24/">Unicode Standard Annex
+ * #24: Script names</ulink>.
+ */
 typedef enum {                         /* ISO 15924 code */
       PANGO_SCRIPT_INVALID_CODE = -1,
       PANGO_SCRIPT_COMMON       = 0,   /* Zyyy */

data/vendor/local/include/pango-1.0/pango/pango-tabs.h

@@ -28,6 +28,12 @@ G_BEGIN_DECLS
 
 typedef struct _PangoTabArray PangoTabArray;
 
+/**
+ * PangoTabAlign:
+ * @PANGO_TAB_LEFT: the tab stop appears to the left of the text.
+ *
+ * A #PangoTabAlign specifies where a tab stop appears relative to the text.
+ */
 typedef enum
 {
   PANGO_TAB_LEFT
@@ -41,6 +47,11 @@ typedef enum
    */
 } PangoTabAlign;
 
+/**
+ * PANGO_TYPE_TAB_ARRAY:
+ *
+ * The #GObject type for #PangoTabArray.
+ */
 #define PANGO_TYPE_TAB_ARRAY (pango_tab_array_get_type ())
 
 PangoTabArray  *pango_tab_array_new                 (gint           initial_size,

data/vendor/local/include/pango-1.0/pango/pango-types.h

@@ -40,10 +40,53 @@ typedef struct _PangoRectangle PangoRectangle;
 
 
 /* A index of a glyph into a font. Rendering system dependent */
+/**
+ * PangoGlyph:
+ *
+ * A #PangoGlyph represents a single glyph in the output form of a string.
+ */
 typedef guint32 PangoGlyph;
 
 
 
+/**
+ * PANGO_SCALE:
+ *
+ * The %PANGO_SCALE macro represents the scale between dimensions used
+ * for Pango distances and device units. (The definition of device
+ * units is dependent on the output device; it will typically be pixels
+ * for a screen, and points for a printer.) %PANGO_SCALE is currently
+ * 1024, but this may be changed in the future.
+ *
+ * When setting font sizes, device units are always considered to be
+ * points (as in "12 point font"), rather than pixels.
+ */
+/**
+ * PANGO_PIXELS:
+ * @d: a dimension in Pango units.
+ *
+ * Converts a dimension to device units by rounding.
+ *
+ * Return value: rounded dimension in device units.
+ */
+/**
+ * PANGO_PIXELS_FLOOR:
+ * @d: a dimension in Pango units.
+ *
+ * Converts a dimension to device units by flooring.
+ *
+ * Return value: floored dimension in device units.
+ * Since: 1.14
+ */
+/**
+ * PANGO_PIXELS_CEIL:
+ * @d: a dimension in Pango units.
+ *
+ * Converts a dimension to device units by ceiling.
+ *
+ * Return value: ceiled dimension in device units.
+ * Since: 1.14
+ */
 #define PANGO_SCALE 1024
 #define PANGO_PIXELS(d) (((int)(d) + 512) >> 10)
 #define PANGO_PIXELS_FLOOR(d) (((int)(d)) >> 10)
@@ -57,6 +100,16 @@ typedef guint32 PangoGlyph;
  * PANGO_PIXELS also behaves differently for +512 and -512.
  */
 
+/**
+ * PANGO_UNITS_ROUND:
+ * @d: a dimension in Pango units.
+ *
+ * Rounds a dimension to whole device units, but does not
+ * convert it to device units.
+ *
+ * Return value: rounded dimension in Pango units.
+ * Since: 1.18
+ */
 #define PANGO_UNITS_ROUND(d)				\
   (((d) + (PANGO_SCALE >> 1)) & ~(PANGO_SCALE - 1))
 
@@ -66,8 +119,17 @@ double pango_units_to_double (int i) G_GNUC_CONST;
 
 
 
-/* A rectangle. Used to store logical and physical extents of glyphs,
- * runs, strings, etc.
+/**
+ * PangoRectangle:
+ * @x: X coordinate of the left side of the rectangle.
+ * @y: Y coordinate of the the top side of the rectangle.
+ * @width: width of the rectangle.
+ * @height: height of the rectangle.
+ *
+ * The #PangoRectangle structure represents a rectangle. It is frequently
+ * used to represent the logical or ink extents of a single glyph or section
+ * of text. (See, for instance, pango_font_get_glyph_extents())
+ *
  */
 struct _PangoRectangle
 {
@@ -79,6 +141,44 @@ struct _PangoRectangle
 
 /* Macros to translate from extents rectangles to ascent/descent/lbearing/rbearing
  */
+/**
+ * PANGO_ASCENT:
+ * @rect: a #PangoRectangle
+ *
+ * Extracts the <firstterm>ascent</firstterm> from a #PangoRectangle
+ * representing glyph extents. The ascent is the distance from the
+ * baseline to the highest point of the character. This is positive if the
+ * glyph ascends above the baseline.
+ */
+/**
+ * PANGO_DESCENT:
+ * @rect: a #PangoRectangle
+ *
+ * Extracts the <firstterm>descent</firstterm> from a #PangoRectangle
+ * representing glyph extents. The descent is the distance from the
+ * baseline to the lowest point of the character. This is positive if the
+ * glyph descends below the baseline.
+ */
+/**
+ * PANGO_LBEARING:
+ * @rect: a #PangoRectangle
+ *
+ * Extracts the <firstterm>left bearing</firstterm> from a #PangoRectangle
+ * representing glyph extents. The left bearing is the distance from the
+ * horizontal origin to the farthest left point of the character.
+ * This is positive for characters drawn completely to the right of the
+ * glyph origin.
+ */
+/**
+ * PANGO_RBEARING:
+ * @rect: a #PangoRectangle
+ *
+ * Extracts the <firstterm>right bearing</firstterm> from a #PangoRectangle
+ * representing glyph extents. The right bearing is the distance from the
+ * horizontal origin to the farthest right point of the character.
+ * This is positive except for characters drawn completely to the left of the
+ * horizontal origin.
+ */
 #define PANGO_ASCENT(rect) (-(rect).y)
 #define PANGO_DESCENT(rect) ((rect).y + (rect).height)
 #define PANGO_LBEARING(rect) ((rect).x)