Commit c61ad157 authored by Matthias Clasen's avatar Matthias Clasen
Browse files

docs: Link syntax fixes

Now that gi-docgen warns about link syntax errors,
we can find and fix them.
parent 3dab00de
Pipeline #285781 passed with stages
in 5 minutes and 56 seconds
......@@ -12,7 +12,7 @@ to instruct Pango about direction of text, though in most cases Pango detects
that correctly and automatically. For application that need more direct
control over bidirectional setting of text, Pango provides APIs such as
[func@unichar_direction], [func@find_base_dir], [func@get_mirror_char]
or [type_func@Pango.BidiType.for_unichar].
or [func@Pango.BidiType.for_unichar].
# Vertical Text
......@@ -43,7 +43,7 @@ of the context can be accessed using [method@Pango.Context.get_base_gravity] and
*resolved* gravity of it using [method@Pango.Context.get_gravity]. The resolved
gravity is the same as the base gravity for the most part, except that if the base
gravity is set to `PANGO_GRAVITY_AUTO`, the resolved gravity will depend on the
current matrix set on context, and is derived using [type_func@Pango.Gravity.get_for_matrix].
current matrix set on context, and is derived using [func@Pango.Gravity.get_for_matrix].
The next thing an application may want to set on the context is the *gravity hint*.
A [enum@Pango.GravityHint] instructs how different scripts should react to the set
......
......@@ -42,7 +42,7 @@ or by parsing a string such as
Helvetica Bold 12pt
with [type_func@Pango.FontDescription.from_string].
with [func@Pango.FontDescription.from_string].
# Glyphs
......
......@@ -1418,7 +1418,7 @@ append_field (GString *str, const char *what, const FieldMap *map, int n_element
*
* Creates a string representation of a font description.
*
* See [type_func@Pango.FontDescription.from_string] for a description
* See [func@Pango.FontDescription.from_string] for a description
* of the format of the string representation. The family list in
* the string description will only have a terminating comma if
* the last word of the list is a valid style option.
......
......@@ -50,7 +50,7 @@ static GHashTable *name_map = NULL; /* MT-safe */
* Allocate a new attribute type ID.
*
* The attribute type name can be accessed later
* by using [type_func@Pango.AttrType.get_name].
* by using [func@Pango.AttrType.get_name].
*
* Return value: the new type ID.
*/
......@@ -85,7 +85,7 @@ pango_attr_type_register (const gchar *name)
*
* The attribute type name is the string passed in
* when registering the type using
* [type_func@attr_type_register].
* [func@Pango.AttrType.register].
*
* The returned value is an interned string (see
* g_intern_string() for what that means) that should
......@@ -1886,7 +1886,7 @@ pango_attr_list_splice (PangoAttrList *list,
*
* Return value: (element-type Pango.Attribute) (transfer full):
* a list of all attributes in @list. To free this value,
* call [mehod@Pango.Attribute.destroy] on each value and
* call [method@Pango.Attribute.destroy] on each value and
* g_slist_free() on the list.
*
* Since: 1.44
......
......@@ -164,7 +164,7 @@ typedef struct _PangoAttrIterator PangoAttrIterator;
* The `PangoAttrType` distinguishes between different types of attributes.
*
* Along with the predefined values, it is possible to allocate additional
* values for custom attributes using [type_func@attr_type_register]. The predefined
* values for custom attributes using [func@AttrType.register]. The predefined
* values are given below. The type of structure used to store the attribute is
* listed in parentheses after the description.
*/
......@@ -445,7 +445,7 @@ struct _PangoAttrSize
* @attr: the common portion of the attribute
* @ink_rect: the ink rectangle to restrict to
* @logical_rect: the logical rectangle to restrict to
* @data: user data set (see [type_func@Pango.AttrShape.new_with_data])
* @data: user data set (see [func@Pango.AttrShape.new_with_data])
* @copy_func: copy function for the user data
* @destroy_func: destroy function for the user data
*
......
......@@ -274,7 +274,7 @@ resolved:
* This function is useful to categorize characters into left-to-right
* letters, right-to-left letters, and everything else. If full Unicode
* bidirectional type of a character is needed,
* [type_func@Pango.BidiType.for_unichar] can be used instead.
* [func@Pango.BidiType.for_unichar] can be used instead.
*
* Return value: the direction of the character.
*/
......
......@@ -403,7 +403,7 @@ pango_context_get_font_description (PangoContext *context)
* Sets the global language tag for the context.
*
* The default language for the locale of the running process
* can be found using [type_func@Pango.Language.get_default].
* can be found using [func@Pango.Language.get_default].
*/
void
pango_context_set_language (PangoContext *context,
......@@ -534,7 +534,7 @@ pango_context_get_base_gravity (PangoContext *context)
*
* This is similar to [method@Pango.Context.get_base_gravity],
* except for when the base gravity is %PANGO_GRAVITY_AUTO for
* which [type_func@Pango.Gravity.get_for_matrix] is used to return the
* which [func@Pango.Gravity.get_for_matrix] is used to return the
* gravity from the current context matrix.
*
* Return value: the resolved gravity for the context.
......@@ -1754,7 +1754,7 @@ update_metrics_from_items (PangoFontMetrics *metrics,
* @language: (nullable): language tag used to determine which script to get
* the metrics for. %NULL means that the language tag from the context
* will be used. If no language tag is set on the context, metrics
* for the default language (as determined by [type_func@Pango.Language.get_default]
* for the default language (as determined by [func@Pango.Language.get_default]
* will be returned.
*
* Get overall metric information for a particular font description.
......
......@@ -276,7 +276,7 @@ pango_gravity_get_for_script (PangoScript script,
* The gravity is determined based on the script, East Asian width,
* base gravity, and hint,
*
* This function is similar to [type_func@Pango.Gravity.get_for_script] except
* This function is similar to [func@Pango.Gravity.get_for_script] except
* that this function makes a distinction between narrow/half-width and
* wide/full-width characters also. Wide/full-width characters always
* stand *upright*, that is, they always take the base gravity,
......
......@@ -317,7 +317,7 @@ pango_language_get_default (void)
* lowercase, mapping '_' to '-', and stripping all characters other
* than letters and '-'.
*
* Use [type_func@Pango.Language.get_default] if you want to get the
* Use [func@Pango.Language.get_default] if you want to get the
* `PangoLanguage` for the current locale of the process.
*
* Return value: (transfer none) (nullable): a `PangoLanguage`
......@@ -383,12 +383,12 @@ const char *
/**
* pango_language_matches:
* @language: (nullable): a language tag (see [type_func@Pango.Language.from_string]),
* @language: (nullable): a language tag (see [func@Pango.Language.from_string]),
* %NULL is allowed and matches nothing but '*'
* @range_list: a list of language ranges, separated by ';', ':',
* ',', or space characters.
* Each element must either be '*', or a RFC 3066 language range
* canonicalized as by [type_func@Pango.Language.from_string]
* canonicalized as by [func@Pango.Language.from_string]
*
* Checks if a language tag matches one of the elements in a list of
* language ranges.
......@@ -569,7 +569,7 @@ static const LangInfo lang_texts[] = {
* as sample text in a font selection dialog.
*
* If @language is %NULL, the default language as found by
* [type_func@Pango.Language.get_default] is used.
* [func@Pango.Language.get_default] is used.
*
* If Pango does not have a sample string for @language, the classic
* "The quick brown fox..." is returned. This can be detected by
......@@ -840,7 +840,7 @@ out:
* The list is specified by the `PANGO_LANGUAGE` or `LANGUAGE`
* environment variables, in order of preference. Note that this
* list does not necessarily include the language returned by
* [type_func@Pango.Language.get_default].
* [func@Pango.Language.get_default].
*
* When choosing language-specific resources, such as the sample
* text returned by [method@Pango.Language.get_sample_string],
......
......@@ -370,7 +370,7 @@ G_DEFINE_BOXED_TYPE (PangoOTRulesetDescription, pango_ot_ruleset_description,
* Creates a copy of @desc, which should be freed with
* [method@PangoOT.RulesetDescription.free].
*
* Primarily used internally by [type_func@PangoOT.Ruleset.get_for_description]
* Primarily used internally by [func@PangoOT.Ruleset.get_for_description]
* to cache rulesets for ruleset descriptions.
*
* Return value: the newly allocated `PangoOTRulesetDescription`
......
......@@ -114,7 +114,7 @@ pango_cairo_font_map_new (void)
* Creates a new `PangoCairoFontMap` object of the type suitable
* to be used with cairo font backend of type @fonttype.
*
* In most cases one should simply use [type_func@PangoCairo.FontMap.new], or
* In most cases one should simply use [func@PangoCairo.FontMap.new], or
* in fact in most of those cases, just use [func@PangoCairo.FontMap.get_default].
*
* Return value: (transfer full) (nullable): the newly allocated
......@@ -201,11 +201,11 @@ pango_cairo_font_map_get_default (void)
* This function only changes the default fontmap for
* the current thread. Default fontmaps of existing threads
* are not changed. Default fontmaps of any new threads will
* still be created using [type_func@PangoCairo.FontMap.new].
* still be created using [func@PangoCairo.FontMap.new].
*
* A value of %NULL for @fontmap will cause the current default
* font map to be released and a new default font map to be created
* on demand, using [type_func@PangoCairo.FontMap.new].
* on demand, using [func@PangoCairo.FontMap.new].
*
* Since: 1.22
*/
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment