GNOME.org
 

[pango/docs-link-fixes] docs: Link syntax fixes


commit c61ad157a7685cd9d7fcbc79d8b9d397360ad16e
Author: Matthias Clasen <mclasen redhat com>
Date:   Tue May 25 11:37:19 2021 -0400

    docs: Link syntax fixes
    
    Now that gi-docgen warns about link syntax errors,
    we can find and fix them.

 docs/pango_bidi.md         |  4 ++--
 docs/pango_fonts.md        |  2 +-
 pango/fonts.c              |  2 +-
 pango/pango-attributes.c   |  6 +++---
 pango/pango-attributes.h   |  4 ++--
 pango/pango-bidi-type.c    |  2 +-
 pango/pango-context.c      |  6 +++---
 pango/pango-gravity.c      |  2 +-
 pango/pango-language.c     | 10 +++++-----
 pango/pango-ot-ruleset.c   |  2 +-
 pango/pangocairo-fontmap.c |  6 +++---
 11 files changed, 23 insertions(+), 23 deletions(-)
---
diff --git a/docs/pango_bidi.md b/docs/pango_bidi.md
index 27005caa..0e8612d1 100644
--- a/docs/pango_bidi.md
+++ b/docs/pango_bidi.md
@@ -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
diff --git a/docs/pango_fonts.md b/docs/pango_fonts.md
index 776dba71..072c020f 100644
--- a/docs/pango_fonts.md
+++ b/docs/pango_fonts.md
@@ -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
 
diff --git a/pango/fonts.c b/pango/fonts.c
index 8f08698c..79cf1251 100644
--- a/pango/fonts.c
+++ b/pango/fonts.c
@@ -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.
diff --git a/pango/pango-attributes.c b/pango/pango-attributes.c
index 0d604f3d..ffd209d6 100644
--- a/pango/pango-attributes.c
+++ b/pango/pango-attributes.c
@@ -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
diff --git a/pango/pango-attributes.h b/pango/pango-attributes.h
index d841d715..3336eb53 100644
--- a/pango/pango-attributes.h
+++ b/pango/pango-attributes.h
@@ -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
  *
diff --git a/pango/pango-bidi-type.c b/pango/pango-bidi-type.c
index e85b23e8..8700836b 100644
--- a/pango/pango-bidi-type.c
+++ b/pango/pango-bidi-type.c
@@ -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.
  */
diff --git a/pango/pango-context.c b/pango/pango-context.c
index 7fa0d7b1..ba77e1d3 100644
--- a/pango/pango-context.c
+++ b/pango/pango-context.c
@@ -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.
diff --git a/pango/pango-gravity.c b/pango/pango-gravity.c
index f01a7349..aa7063b1 100644
--- a/pango/pango-gravity.c
+++ b/pango/pango-gravity.c
@@ -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,
diff --git a/pango/pango-language.c b/pango/pango-language.c
index 410550db..bf492a9e 100644
--- a/pango/pango-language.c
+++ b/pango/pango-language.c
@@ -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],
diff --git a/pango/pango-ot-ruleset.c b/pango/pango-ot-ruleset.c
index 82a6ceca..0398d9e6 100644
--- a/pango/pango-ot-ruleset.c
+++ b/pango/pango-ot-ruleset.c
@@ -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`
diff --git a/pango/pangocairo-fontmap.c b/pango/pangocairo-fontmap.c
index f16c3869..70bc66dc 100644
--- a/pango/pangocairo-fontmap.c
+++ b/pango/pangocairo-fontmap.c
@@ -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
  */
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]