summaryrefslogtreecommitdiff
path: root/pango
diff options
context:
space:
mode:
authorGuillaume Gomez <guillaume1.gomez@gmail.com>2022-10-12 14:58:05 +0000
committerGuillaume Gomez <guillaume1.gomez@gmail.com>2022-10-12 14:58:05 +0000
commita95fe00de9f3b906fe4acefd8f92aa4691a0e155 (patch)
tree2a46ff1c8c0dd140caffa85ea7b72807034104e0 /pango
parent7bd0238ebcf7873628d7b84ac32ab972b6f792fd (diff)
downloadpango-a95fe00de9f3b906fe4acefd8f92aa4691a0e155.tar.gz
Fix GIR annotations in multiple files
Diffstat (limited to 'pango')
-rw-r--r--pango/pango-fontset.c4
-rw-r--r--pango/pango-glyph-item.c18
-rw-r--r--pango/pango-layout.c94
-rw-r--r--pango/pango-utils.c36
4 files changed, 76 insertions, 76 deletions
diff --git a/pango/pango-fontset.c b/pango/pango-fontset.c
index fc9e05b8..dc9d0354 100644
--- a/pango/pango-fontset.c
+++ b/pango/pango-fontset.c
@@ -55,7 +55,7 @@ pango_fontset_class_init (PangoFontsetClass *class)
* Returns the font in the fontset that contains the best
* glyph for a Unicode character.
*
- * Return value: (transfer full): a `PangoFont`
+ * Returns: (transfer full): a `PangoFont`
*/
PangoFont *
pango_fontset_get_font (PangoFontset *fontset,
@@ -73,7 +73,7 @@ pango_fontset_get_font (PangoFontset *fontset,
*
* Get overall metric information for the fonts in the fontset.
*
- * Return value: a `PangoFontMetrics` object
+ * Returns: (transfer full): a `PangoFontMetrics` object
*/
PangoFontMetrics *
pango_fontset_get_metrics (PangoFontset *fontset)
diff --git a/pango/pango-glyph-item.c b/pango/pango-glyph-item.c
index 7eb1737d..e58f6593 100644
--- a/pango/pango-glyph-item.c
+++ b/pango/pango-glyph-item.c
@@ -47,8 +47,8 @@
* This function is similar in function to pango_item_split() (and uses
* it internally.)
*
- * Return value: the newly allocated item representing text before
- * @split_index, which should be freed
+ * Returns: (transfer full) (nullable): the newly allocated item
+ * representing text before @split_index, which should be freed
* with pango_glyph_item_free().
*
* Since: 1.2
@@ -142,7 +142,7 @@ pango_glyph_item_split (PangoGlyphItem *orig,
*
* Make a deep copy of an existing `PangoGlyphItem` structure.
*
- * Return value: (nullable): the newly allocated `PangoGlyphItem`
+ * Returns: (transfer full) (nullable): the newly allocated `PangoGlyphItem`
*
* Since: 1.20
*/
@@ -198,7 +198,7 @@ G_DEFINE_BOXED_TYPE (PangoGlyphItem, pango_glyph_item,
*
* Make a shallow copy of an existing `PangoGlyphItemIter` structure.
*
- * Return value: (nullable): the newly allocated `PangoGlyphItemIter`
+ * Returns: (transfer full) (nullable): the newly allocated `PangoGlyphItemIter`
*
* Since: 1.22
*/
@@ -246,7 +246,7 @@ G_DEFINE_BOXED_TYPE (PangoGlyphItemIter, pango_glyph_item_iter,
*
* See `PangoGlyphItemIter` for details of cluster orders.
*
- * Return value: %TRUE if the iterator was advanced,
+ * Returns: %TRUE if the iterator was advanced,
* %FALSE if we were already on the last cluster.
*
* Since: 1.22
@@ -336,7 +336,7 @@ pango_glyph_item_iter_next_cluster (PangoGlyphItemIter *iter)
* Moves the iterator to the preceding cluster in the glyph item.
* See `PangoGlyphItemIter` for details of cluster orders.
*
- * Return value: %TRUE if the iterator was moved,
+ * Returns: %TRUE if the iterator was moved,
* %FALSE if we were already on the first cluster.
*
* Since: 1.22
@@ -433,7 +433,7 @@ pango_glyph_item_iter_prev_cluster (PangoGlyphItemIter *iter)
*
* See `PangoGlyphItemIter` for details of cluster orders.
*
- * Return value: %FALSE if there are no clusters in the glyph item
+ * Returns: %FALSE if there are no clusters in the glyph item
*
* Since: 1.22
*/
@@ -472,7 +472,7 @@ pango_glyph_item_iter_init_start (PangoGlyphItemIter *iter,
*
* See `PangoGlyphItemIter` for details of cluster orders.
*
- * Return value: %FALSE if there are no clusters in the glyph item
+ * Returns: %FALSE if there are no clusters in the glyph item
*
* Since: 1.22
*/
@@ -582,7 +582,7 @@ split_before_cluster_start (ApplyAttrsState *state)
* This function takes ownership of @glyph_item; it will be reused
* as one of the elements in the list.
*
- * Return value: (transfer full) (element-type Pango.GlyphItem): a
+ * Returns: (transfer full) (element-type Pango.GlyphItem): a
* list of glyph items resulting from splitting @glyph_item. Free
* the elements using [method@Pango.GlyphItem.free], the list using
* g_slist_free().
diff --git a/pango/pango-layout.c b/pango/pango-layout.c
index a1c47203..306741b5 100644
--- a/pango/pango-layout.c
+++ b/pango/pango-layout.c
@@ -280,7 +280,7 @@ pango_layout_finalize (GObject *object)
* Create a new `PangoLayout` object with attributes initialized to
* default values for a particular `PangoContext`.
*
- * Return value: the newly allocated `PangoLayout`
+ * Returns: (transfer full): the newly allocated `PangoLayout`
*/
PangoLayout *
pango_layout_new (PangoContext *context)
@@ -307,7 +307,7 @@ pango_layout_new (PangoContext *context)
* The attribute list, tab array, and text from the original layout
* are all copied by value.
*
- * Return value: (transfer full): the newly allocated `PangoLayout`
+ * Returns: (transfer full): the newly allocated `PangoLayout`
*/
PangoLayout*
pango_layout_copy (PangoLayout *src)
@@ -342,7 +342,7 @@ pango_layout_copy (PangoLayout *src)
*
* Retrieves the `PangoContext` used for this layout.
*
- * Return value: (transfer none): the `PangoContext` for the layout
+ * Returns: (transfer none): the `PangoContext` for the layout
*/
PangoContext *
pango_layout_get_context (PangoLayout *layout)
@@ -385,7 +385,7 @@ pango_layout_set_width (PangoLayout *layout,
*
* Gets the width to which the lines of the `PangoLayout` should wrap.
*
- * Return value: the width in Pango units, or -1 if no width set.
+ * Returns: the width in Pango units, or -1 if no width set.
*/
int
pango_layout_get_width (PangoLayout *layout)
@@ -457,7 +457,7 @@ pango_layout_set_height (PangoLayout *layout,
*
* See [method@Pango.Layout.set_height] for details.
*
- * Return value: the height, in Pango units if positive,
+ * Returns: the height, in Pango units if positive,
* or number of lines if negative.
*
* Since: 1.20
@@ -506,7 +506,7 @@ pango_layout_set_wrap (PangoLayout *layout,
* Use [method@Pango.Layout.is_wrapped] to query whether
* any paragraphs were actually wrapped.
*
- * Return value: active wrap mode.
+ * Returns: active wrap mode.
*/
PangoWrapMode
pango_layout_get_wrap (PangoLayout *layout)
@@ -527,7 +527,7 @@ pango_layout_get_wrap (PangoLayout *layout)
* and there are paragraphs exceeding the layout width that have
* to be wrapped.
*
- * Return value: %TRUE if any paragraphs had to be wrapped, %FALSE
+ * Returns: %TRUE if any paragraphs had to be wrapped, %FALSE
* otherwise
*
* Since: 1.16
@@ -579,7 +579,7 @@ pango_layout_set_indent (PangoLayout *layout,
*
* A negative value indicates a hanging indentation.
*
- * Return value: the indent in Pango units
+ * Returns: the indent in Pango units
*/
int
pango_layout_get_indent (PangoLayout *layout)
@@ -629,7 +629,7 @@ pango_layout_set_spacing (PangoLayout *layout,
*
* Gets the amount of spacing between the lines of the layout.
*
- * Return value: the spacing in Pango units
+ * Returns: the spacing in Pango units
*/
int
pango_layout_get_spacing (PangoLayout *layout)
@@ -740,7 +740,7 @@ pango_layout_set_attributes (PangoLayout *layout,
*
* Gets the attribute list for the layout, if any.
*
- * Return value: (transfer none) (nullable): a `PangoAttrList`
+ * Returns: (transfer none) (nullable): a `PangoAttrList`
*/
PangoAttrList*
pango_layout_get_attributes (PangoLayout *layout)
@@ -786,7 +786,7 @@ pango_layout_set_font_description (PangoLayout *layout,
*
* Gets the font description for the layout, if any.
*
- * Return value: (transfer none) (nullable): a pointer to the
+ * Returns: (transfer none) (nullable): a pointer to the
* layout's font description, or %NULL if the font description
* from the layout's context is inherited.
*
@@ -847,7 +847,7 @@ pango_layout_set_justify (PangoLayout *layout,
* Gets whether each complete line should be stretched to fill the entire
* width of the layout.
*
- * Return value: the justify value
+ * Returns: the justify value
*/
gboolean
pango_layout_get_justify (PangoLayout *layout)
@@ -893,7 +893,7 @@ pango_layout_set_justify_last_line (PangoLayout *layout,
* Gets whether the last line should be stretched
* to fill the entire width of the layout.
*
- * Return value: the justify value
+ * Returns: the justify value
*
* Since: 1.50
*/
@@ -953,7 +953,7 @@ pango_layout_set_auto_dir (PangoLayout *layout,
*
* See [method@Pango.Layout.set_auto_dir].
*
- * Return value: %TRUE if the bidirectional base direction
+ * Returns: %TRUE if the bidirectional base direction
* is computed from the layout's contents, %FALSE otherwise
*
* Since: 1.4
@@ -996,7 +996,7 @@ pango_layout_set_alignment (PangoLayout *layout,
* Gets the alignment for the layout: how partial lines are
* positioned within the horizontal space available.
*
- * Return value: the alignment
+ * Returns: the alignment
*/
PangoAlignment
pango_layout_get_alignment (PangoLayout *layout)
@@ -1057,7 +1057,7 @@ pango_layout_set_tabs (PangoLayout *layout,
*
* The return value should be freed with [method@Pango.TabArray.free].
*
- * Return value: (transfer full) (nullable): a copy of the tabs for this layout
+ * Returns: (transfer full) (nullable): a copy of the tabs for this layout
*/
PangoTabArray*
pango_layout_get_tabs (PangoLayout *layout)
@@ -1107,7 +1107,7 @@ pango_layout_set_single_paragraph_mode (PangoLayout *layout,
*
* See [method@Pango.Layout.set_single_paragraph_mode].
*
- * Return value: %TRUE if the layout does not break paragraphs
+ * Returns: %TRUE if the layout does not break paragraphs
* at paragraph separator characters, %FALSE otherwise
*/
gboolean
@@ -1167,7 +1167,7 @@ pango_layout_set_ellipsize (PangoLayout *layout,
* Use [method@Pango.Layout.is_ellipsized] to query whether any
* paragraphs were actually ellipsized.
*
- * Return value: the current ellipsization mode for @layout
+ * Returns: the current ellipsization mode for @layout
*
* Since: 1.6
*/
@@ -1190,7 +1190,7 @@ pango_layout_get_ellipsize (PangoLayout *layout)
* and there are paragraphs exceeding that width that have to be
* ellipsized.
*
- * Return value: %TRUE if any paragraphs had to be ellipsized,
+ * Returns: %TRUE if any paragraphs had to be ellipsized,
* %FALSE otherwise
*
* Since: 1.16
@@ -1297,7 +1297,7 @@ pango_layout_set_text (PangoLayout *layout,
*
* The returned text should not be freed or modified.
*
- * Return value: (transfer none): the text in the @layout
+ * Returns: (transfer none): the text in the @layout
*/
const char*
pango_layout_get_text (PangoLayout *layout)
@@ -1319,7 +1319,7 @@ pango_layout_get_text (PangoLayout *layout)
* Returns the number of Unicode characters in the
* the text of @layout.
*
- * Return value: the number of Unicode characters
+ * Returns: the number of Unicode characters
* in the text of @layout
*
* Since: 1.30
@@ -1423,7 +1423,7 @@ pango_layout_set_markup_with_accel (PangoLayout *layout,
* used in combination with %PANGO_ATTR_FALLBACK, to check if a
* certain font supports all the characters in the string.
*
- * Return value: The number of unknown glyphs in @layout
+ * Returns: The number of unknown glyphs in @layout
*
* Since: 1.16
*/
@@ -1525,7 +1525,7 @@ pango_layout_context_changed (PangoLayout *layout)
* To force the serial to be increased, use
* [method@Pango.Layout.context_changed].
*
- * Return value: The current serial number of @layout.
+ * Returns: The current serial number of @layout.
*
* Since: 1.32.4
*/
@@ -1615,7 +1615,7 @@ pango_layout_get_log_attrs_readonly (PangoLayout *layout,
*
* Retrieves the count of lines for the @layout.
*
- * Return value: the line count
+ * Returns: the line count
*/
int
pango_layout_get_line_count (PangoLayout *layout)
@@ -1635,7 +1635,7 @@ pango_layout_get_line_count (PangoLayout *layout)
* Use the faster [method@Pango.Layout.get_lines_readonly] if you do not
* plan to modify the contents of the lines (glyphs, glyph widths, etc.).
*
- * Return value: (element-type Pango.LayoutLine) (transfer none): a `GSList`
+ * Returns: (element-type Pango.LayoutLine) (transfer none): a `GSList`
* containing the lines in the layout. This points to internal data of the
* `PangoLayout` and must be used with care. It will become invalid on any
* change to the layout's text or properties.
@@ -1670,7 +1670,7 @@ pango_layout_get_lines (PangoLayout *layout)
* but the user is not expected to modify the contents of the lines
* (glyphs, glyph widths, etc.).
*
- * Return value: (element-type Pango.LayoutLine) (transfer none): a `GSList`
+ * Returns: (element-type Pango.LayoutLine) (transfer none): a `GSList`
* containing the lines in the layout. This points to internal data of the
* `PangoLayout` and must be used with care. It will become invalid on any
* change to the layout's text or properties. No changes should be made to
@@ -1697,7 +1697,7 @@ pango_layout_get_lines_readonly (PangoLayout *layout)
* Use the faster [method@Pango.Layout.get_line_readonly] if you do not
* plan to modify the contents of the line (glyphs, glyph widths, etc.).
*
- * Return value: (transfer none) (nullable): the requested `PangoLayoutLine`,
+ * Returns: (transfer none) (nullable): the requested `PangoLayoutLine`,
* or %NULL if the index is out of range. This layout line can be ref'ed
* and retained, but will become invalid if changes are made to the
* `PangoLayout`.
@@ -1739,7 +1739,7 @@ pango_layout_get_line (PangoLayout *layout,
* but the user is not expected to modify the contents of the line
* (glyphs, glyph widths, etc.).
*
- * Return value: (transfer none) (nullable): the requested `PangoLayoutLine`,
+ * Returns: (transfer none) (nullable): the requested `PangoLayoutLine`,
* or %NULL if the index is out of range. This layout line can be ref'ed
* and retained, but will become invalid if changes are made to the
* `PangoLayout`. No changes should be made to the line.
@@ -2291,7 +2291,7 @@ pango_layout_move_cursor_visually (PangoLayout *layout,
* the X or Y positions were not inside the layout, then the function returns
* %FALSE; on an exact hit, it returns %TRUE.
*
- * Return value: %TRUE if the coordinates were inside text, %FALSE otherwise
+ * Returns: %TRUE if the coordinates were inside text, %FALSE otherwise
*/
gboolean
pango_layout_xy_to_index (PangoLayout *layout,
@@ -2385,7 +2385,7 @@ pango_layout_xy_to_index (PangoLayout *layout,
* Converts from an index within a `PangoLayout` to the onscreen position
* corresponding to the grapheme at that index.
*
- * The return value is represented as rectangle. Note that `pos->x` is
+ * The returns is represented as rectangle. Note that `pos->x` is
* always the leading edge of the grapheme and `pos->x + pos->width` the
* trailing edge of the grapheme. If the directionality of the grapheme
* is right-to-left, then `pos->width` will be negative.
@@ -3206,7 +3206,7 @@ pango_layout_get_pixel_size (PangoLayout *layout,
*
* Gets the Y position of baseline of the first line in @layout.
*
- * Return value: baseline of first line, from top of @layout
+ * Returns: baseline of first line, from top of @layout
*
* Since: 1.22
*/
@@ -4986,7 +4986,7 @@ pango_layout_check_lines (PangoLayout *layout)
*
* Increase the reference count of a `PangoLayoutLine` by one.
*
- * Return value: the line passed in.
+ * Returns: (transfer full) (nullable): the line passed in.
*
* Since: 1.10
*/
@@ -5121,7 +5121,7 @@ pango_layout_line_get_resolved_direction (PangoLayoutLine *line)
* in the line and @trailing being set to the number of characters in that
* grapheme. The reverse is true for a left-to-right line.
*
- * Return value: %FALSE if @x_pos was outside the line, %TRUE if inside
+ * Returns: %FALSE if @x_pos was outside the line, %TRUE if inside
*/
gboolean
pango_layout_line_x_to_index (PangoLayoutLine *line,
@@ -7124,7 +7124,7 @@ update_run (PangoLayoutIter *iter,
*
* Copies a `PangoLayoutIter`.
*
- * Return value: (nullable): the newly allocated `PangoLayoutIter`
+ * Returns: (transfer full) (nullable): the newly allocated `PangoLayoutIter`
*
* Since: 1.20
*/
@@ -7184,7 +7184,7 @@ G_DEFINE_BOXED_TYPE (PangoLayoutIter, pango_layout_iter,
*
* Returns an iterator to iterate over the visual extents of the layout.
*
- * Return value: the new `PangoLayoutIter`
+ * Returns: (transfer full): the new `PangoLayoutIter`
*/
PangoLayoutIter*
pango_layout_get_iter (PangoLayout *layout)
@@ -7290,7 +7290,7 @@ pango_layout_iter_free (PangoLayoutIter *iter)
* the index may be equal to the length of the text in the
* layout, if on the %NULL run (see [method@Pango.LayoutIter.get_run]).
*
- * Return value: current byte index
+ * Returns: current byte index
*/
int
pango_layout_iter_get_index (PangoLayoutIter *iter)
@@ -7315,7 +7315,7 @@ pango_layout_iter_get_index (PangoLayoutIter *iter)
* Use the faster [method@Pango.LayoutIter.get_run_readonly] if you do not
* plan to modify the contents of the run (glyphs, glyph widths, etc.).
*
- * Return value: (transfer none) (nullable): the current run
+ * Returns: (transfer none) (nullable): the current run
*/
PangoLayoutRun*
pango_layout_iter_get_run (PangoLayoutIter *iter)
@@ -7343,7 +7343,7 @@ pango_layout_iter_get_run (PangoLayoutIter *iter)
* but the user is not expected to modify the contents of the run (glyphs,
* glyph widths, etc.).
*
- * Return value: (transfer none) (nullable): the current run, that
+ * Returns: (transfer none) (nullable): the current run, that
* should not be modified
*
* Since: 1.16
@@ -7382,7 +7382,7 @@ _pango_layout_iter_get_run (PangoLayoutIter *iter)
* you do not plan to modify the contents of the line (glyphs,
* glyph widths, etc.).
*
- * Return value: (transfer none): the current line
+ * Returns: (transfer none) (nullable): the current line
*/
PangoLayoutLine*
pango_layout_iter_get_line (PangoLayoutIter *iter)
@@ -7405,7 +7405,7 @@ pango_layout_iter_get_line (PangoLayoutIter *iter)
* but the user is not expected to modify the contents of the line
* (glyphs, glyph widths, etc.).
*
- * Return value: (transfer none): the current line, that should not be
+ * Returns: (transfer none) (nullable): the current line, that should not be
* modified
*
* Since: 1.16
@@ -7425,7 +7425,7 @@ pango_layout_iter_get_line_readonly (PangoLayoutIter *iter)
*
* Determines whether @iter is on the last line of the layout.
*
- * Return value: %TRUE if @iter is on the last line
+ * Returns: %TRUE if @iter is on the last line
*/
gboolean
pango_layout_iter_at_last_line (PangoLayoutIter *iter)
@@ -7442,7 +7442,7 @@ pango_layout_iter_at_last_line (PangoLayoutIter *iter)
*
* Gets the layout associated with a `PangoLayoutIter`.
*
- * Return value: (transfer none): the layout associated with @iter
+ * Returns: (transfer none) (nullable): the layout associated with @iter
*
* Since: 1.20
*/
@@ -7566,7 +7566,7 @@ next_cluster_internal (PangoLayoutIter *iter,
*
* If @iter was already at the end of the layout, returns %FALSE.
*
- * Return value: whether motion was possible
+ * Returns: whether motion was possible
*/
gboolean
pango_layout_iter_next_char (PangoLayoutIter *iter)
@@ -7611,7 +7611,7 @@ pango_layout_iter_next_char (PangoLayoutIter *iter)
*
* If @iter was already at the end of the layout, returns %FALSE.
*
- * Return value: whether motion was possible
+ * Returns: whether motion was possible
*/
gboolean
pango_layout_iter_next_cluster (PangoLayoutIter *iter)
@@ -7627,7 +7627,7 @@ pango_layout_iter_next_cluster (PangoLayoutIter *iter)
*
* If @iter was already at the end of the layout, returns %FALSE.
*
- * Return value: whether motion was possible
+ * Returns: whether motion was possible
*/
gboolean
pango_layout_iter_next_run (PangoLayoutIter *iter)
@@ -7672,7 +7672,7 @@ pango_layout_iter_next_run (PangoLayoutIter *iter)
*
* If @iter is already on the last line, returns %FALSE.
*
- * Return value: whether motion was possible
+ * Returns: whether motion was possible
*/
gboolean
pango_layout_iter_next_line (PangoLayoutIter *iter)
@@ -7991,7 +7991,7 @@ pango_layout_iter_get_line_yrange (PangoLayoutIter *iter,
*
* Layout coordinates have the origin at the top left of the entire layout.
*
- * Return value: baseline of current line
+ * Returns: baseline of current line
*/
int
pango_layout_iter_get_baseline (PangoLayoutIter *iter)
diff --git a/pango/pango-utils.c b/pango/pango-utils.c
index b942921e..ce294230 100644
--- a/pango/pango-utils.c
+++ b/pango/pango-utils.c
@@ -76,7 +76,7 @@ pango_version (void)
* This is similar to the macro %PANGO_VERSION_STRING except that the
* macro returns the version available at compile-time.
*
- * Returns: A string containing the version of Pango library available
+ * Returns: (transfer none): A string containing the version of Pango library available
* at run time. The returned string is owned by Pango and should not
* be modified or freed.
*
@@ -112,7 +112,7 @@ pango_version_string (void)
*
* For compile-time version checking use PANGO_VERSION_CHECK().
*
- * Return value: (nullable): %NULL if the Pango library is compatible
+ * Returns: (transfer none) (nullable): %NULL if the Pango library is compatible
* with the given version, or a string describing the version
* mismatch. The returned string is owned by Pango and should not
* be modified or freed.
@@ -144,7 +144,7 @@ pango_version_check (int required_major,
*
* Trims leading and trailing whitespace from a string.
*
- * Return value: A newly-allocated string that must be freed with g_free()
+ * Returns: (transfer full): A newly-allocated string that must be freed with g_free()
*
* Deprecated: 1.38
*/
@@ -178,7 +178,7 @@ _pango_trim_string (const char *str)
* Splits a %G_SEARCHPATH_SEPARATOR-separated list of files, stripping
* white space and substituting ~/ with $HOME/.
*
- * Return value: (transfer full) (array zero-terminated=1): a list of
+ * Returns: (transfer full) (array zero-terminated=1): a list of
* strings to be freed with g_strfreev()
*
* Deprecated: 1.38
@@ -251,7 +251,7 @@ pango_split_file_list (const char *str)
* any other character is ignored and written into the output buffer
* unmodified.
*
- * Return value: 0 if the stream was already at an %EOF character,
+ * Returns: 0 if the stream was already at an %EOF character,
* otherwise the number of lines read (this is useful for maintaining
* a line number counter which doesn't combine lines with '\')
*
@@ -356,7 +356,7 @@ pango_read_line (FILE *stream, GString *str)
*
* Skips 0 or more characters of white space.
*
- * Return value: %FALSE if skipping the white space leaves
+ * Returns: %FALSE if skipping the white space leaves
* the position at a '\0' character.
*
* Deprecated: 1.38
@@ -384,7 +384,7 @@ pango_skip_space (const char **pos)
* A word consists of [A-Za-z_] followed by zero or more
* [A-Za-z_0-9]. Leading white space is skipped.
*
- * Return value: %FALSE if a parse error occurred
+ * Returns: %FALSE if a parse error occurred
*
* Deprecated: 1.38
*/
@@ -430,7 +430,7 @@ pango_scan_word (const char **pos, GString *out)
* or a quoted string with '"'. Instead a quoted string, '\"' represents
* a literal quote. Leading white space outside of quotes is skipped.
*
- * Return value: %FALSE if a parse error occurred
+ * Returns: %FALSE if a parse error occurred
*
* Deprecated: 1.38
*/
@@ -521,7 +521,7 @@ pango_scan_string (const char **pos, GString *out)
*
* Leading white space is skipped.
*
- * Return value: %FALSE if a parse error occurred
+ * Returns: %FALSE if a parse error occurred
*
* Deprecated: 1.38
*/
@@ -562,7 +562,7 @@ _pango_scan_int (const char **pos, int *out)
*
* Do not use. Does not do anything.
*
- * Return value: %NULL
+ * Returns: (nullable): %NULL
*
* Deprecated: 1.38
*/
@@ -578,7 +578,7 @@ pango_config_key_get_system (const char *key)
*
* Do not use. Does not do anything.
*
- * Return value: %NULL
+ * Returns: (nullable): %NULL
*
* Deprecated: 1.38
*/
@@ -594,7 +594,7 @@ pango_config_key_get (const char *key)
* Returns the name of the "pango" subdirectory of SYSCONFDIR
* (which is set at compile time).
*
- * Return value: the Pango sysconf directory. The returned string should
+ * Returns: (transfer none): the Pango sysconf directory. The returned string should
* not be freed.
*
* Deprecated: 1.38
@@ -623,7 +623,7 @@ pango_get_sysconf_subdirectory (void)
* Returns the name of the "pango" subdirectory of LIBDIR
* (which is set at compile time).
*
- * Return value: the Pango lib directory. The returned string should
+ * Returns: (transfer none): the Pango lib directory. The returned string should
* not be freed.
*
* Deprecated: 1.38
@@ -692,7 +692,7 @@ parse_int (const char *word,
* If failed and @possible_values is not %NULL, returned string should
* be freed using g_free().
*
- * Return value: %TRUE if @str was successfully parsed
+ * Returns: %TRUE if @str was successfully parsed
*
* Deprecated: 1.38
*
@@ -858,7 +858,7 @@ pango_lookup_aliases (const char *fontname,
* Searches a string the first character that has a strong
* direction, according to the Unicode bidirectional algorithm.
*
- * Return value: The direction corresponding to the first strong character.
+ * Returns: The direction corresponding to the first strong character.
* If no such character is found, then %PANGO_DIRECTION_NEUTRAL is returned.
*
* Since: 1.4
@@ -901,7 +901,7 @@ pango_find_base_dir (const gchar *text,
*
* This is totally different from [func@GLib.unichar_iszerowidth] and is at best misnamed.
*
- * Return value: %TRUE if @ch is a zero-width character, %FALSE otherwise
+ * Returns: %TRUE if @ch is a zero-width character, %FALSE otherwise
*
* Since: 1.10
*/
@@ -997,7 +997,7 @@ pango_quantize_line_geometry (int *thickness,
* The conversion is done by multiplying @d by %PANGO_SCALE and
* rounding the result to nearest integer.
*
- * Return value: the value in Pango units.
+ * Returns: the value in Pango units.
*
* Since: 1.16
*/
@@ -1015,7 +1015,7 @@ pango_units_from_double (double d)
*
* The conversion is done by dividing @i by %PANGO_SCALE.
*
- * Return value: the double value.
+ * Returns: the double value.
*
* Since: 1.16
*/