summaryrefslogtreecommitdiff
path: root/gtk/css
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2021-05-20 09:17:04 -0400
committerMatthias Clasen <mclasen@redhat.com>2021-05-22 17:25:26 -0400
commit91f7b9663fb17ebe26a28ec589a727397eef0967 (patch)
tree0d53b59b4e28bd4c879bf2081f8bef1993a5b298 /gtk/css
parent2d266d107b2db1c1bf478bf7c93e38884c86c366 (diff)
downloadgtk+-91f7b9663fb17ebe26a28ec589a727397eef0967.tar.gz
gtk: Clean up docs syntax
Replace leftover gtk-doc syntax (#Type) with backquotes.
Diffstat (limited to 'gtk/css')
-rw-r--r--gtk/css/gtkcssdataurl.c4
-rw-r--r--gtk/css/gtkcssenums.h2
-rw-r--r--gtk/css/gtkcsserror.h4
-rw-r--r--gtk/css/gtkcssparser.c36
-rw-r--r--gtk/css/gtkcsssection.c4
-rw-r--r--gtk/css/gtkcsstokenizer.c4
6 files changed, 27 insertions, 27 deletions
diff --git a/gtk/css/gtkcssdataurl.c b/gtk/css/gtkcssdataurl.c
index 77ab75687e..6645b4835d 100644
--- a/gtk/css/gtkcssdataurl.c
+++ b/gtk/css/gtkcssdataurl.c
@@ -42,8 +42,8 @@
*
* Decodes a data URL according to RFC2397 and returns the decoded data.
*
- * Returns: a new #GBytes with the decoded data
- **/
+ * Returns: a new `GBytes` with the decoded data
+ */
GBytes *
gtk_css_data_url_parse (const char *url,
char **out_mimetype,
diff --git a/gtk/css/gtkcssenums.h b/gtk/css/gtkcssenums.h
index e83797e11a..7c42f33194 100644
--- a/gtk/css/gtkcssenums.h
+++ b/gtk/css/gtkcssenums.h
@@ -64,7 +64,7 @@ typedef enum
*
* Warnings that can occur while parsing CSS.
*
- * Unlike #GtkCssParserErrors, warnings do not cause the parser to
+ * Unlike `GtkCssParserError`s, warnings do not cause the parser to
* skip any input, but they indicate issues that should be fixed.
*/
typedef enum
diff --git a/gtk/css/gtkcsserror.h b/gtk/css/gtkcsserror.h
index a9392a2317..91bf5908fb 100644
--- a/gtk/css/gtkcsserror.h
+++ b/gtk/css/gtkcsserror.h
@@ -29,7 +29,7 @@ G_BEGIN_DECLS
/**
* GTK_CSS_PARSER_ERROR:
*
- * Domain for #GtkCssParser errors.
+ * Domain for `GtkCssParser` errors.
*/
#define GTK_CSS_PARSER_ERROR (gtk_css_parser_error_quark ())
@@ -39,7 +39,7 @@ GQuark gtk_css_parser_error_quark (void);
/**
* GTK_CSS_PARSER_WARNING:
*
- * Domain for #GtkCssParser warnings.
+ * Domain for `GtkCssParser` warnings.
*/
#define GTK_CSS_PARSER_WARNING (gtk_css_parser_warning_quark ())
diff --git a/gtk/css/gtkcssparser.c b/gtk/css/gtkcssparser.c
index f8b403c3d8..aa2e171aa1 100644
--- a/gtk/css/gtkcssparser.c
+++ b/gtk/css/gtkcssparser.c
@@ -152,7 +152,7 @@ gtk_css_parser_unref (GtkCssParser *self)
/**
* gtk_css_parser_get_file:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
*
* Gets the file being parsed. If no file is associated with @self -
* for example when raw data is parsed - %NULL is returned.
@@ -167,7 +167,7 @@ gtk_css_parser_get_file (GtkCssParser *self)
/**
* gtk_css_parser_resolve_url:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
* @url: the URL to resolve
*
* Resolves a given URL against the parser's location.
@@ -198,7 +198,7 @@ gtk_css_parser_resolve_url (GtkCssParser *self,
/**
* gtk_css_parser_get_start_location:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
*
* Queries the location of the current token.
*
@@ -222,7 +222,7 @@ gtk_css_parser_get_start_location (GtkCssParser *self)
/**
* gtk_css_parser_get_end_location:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
* @out_location: (caller-allocates) Place to store the location
*
* Queries the location of the current token.
@@ -247,7 +247,7 @@ gtk_css_parser_get_end_location (GtkCssParser *self)
/**
* gtk_css_parser_get_block_location:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
*
* Queries the start location of the token that started the current
* block that is being parsed.
@@ -450,7 +450,7 @@ gtk_css_parser_end_block (GtkCssParser *self)
/*
* gtk_css_parser_skip:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
*
* Skips a component value.
*
@@ -477,7 +477,7 @@ gtk_css_parser_skip (GtkCssParser *self)
/*
* gtk_css_parser_skip_until:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
* @token_type: type of token to skip to
*
* Repeatedly skips a token until a certain type is reached.
@@ -700,7 +700,7 @@ gtk_css_parser_consume_function (GtkCssParser *self,
/**
* gtk_css_parser_has_token:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
* @token_type: type of the token to check
*
* Checks if the next token is of @token_type.
@@ -720,7 +720,7 @@ gtk_css_parser_has_token (GtkCssParser *self,
/**
* gtk_css_parser_has_ident:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
* @ident: name of identifier
*
* Checks if the next token is an identifier with the given @name.
@@ -752,7 +752,7 @@ gtk_css_parser_has_integer (GtkCssParser *self)
/**
* gtk_css_parser_has_function:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
* @name: name of function
*
* Checks if the next token is a function with the given @name.
@@ -773,7 +773,7 @@ gtk_css_parser_has_function (GtkCssParser *self,
/**
* gtk_css_parser_try_delim:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
* @codepoint: unicode character codepoint to check
*
* Checks if the current token is a delimiter matching the given
@@ -803,7 +803,7 @@ gtk_css_parser_try_delim (GtkCssParser *self,
/**
* gtk_css_parser_try_ident:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
* @ident: identifier to check for
*
* Checks if the current token is an identifier matching the given
@@ -830,7 +830,7 @@ gtk_css_parser_try_ident (GtkCssParser *self,
/**
* gtk_css_parser_try_at_keyword:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
* @keyword: name of keyword to check for
*
* Checks if the current token is an at-keyword token with the
@@ -857,7 +857,7 @@ gtk_css_parser_try_at_keyword (GtkCssParser *self,
/**
* gtk_css_parser_try_token:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
* @token_type: type of token to try
*
* Consumes the next token if it matches the given @token_type.
@@ -886,7 +886,7 @@ gtk_css_parser_try_token (GtkCssParser *self,
/**
* gtk_css_parser_consume_ident:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
*
* If the current token is an identifier, consumes it and returns
* its name.
@@ -918,7 +918,7 @@ gtk_css_parser_consume_ident (GtkCssParser *self)
/**
* gtk_css_parser_consume_string:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
*
* If the current token is a string, consumes it and return the string.
*
@@ -963,11 +963,11 @@ gtk_css_parser_parse_url_arg (GtkCssParser *parser,
/**
* gtk_css_parser_consume_url:
- * @self: a #GtkCssParser
+ * @self: a `GtkCssParser`
*
* If the parser matches the <url> token from the [CSS
* specification](https://drafts.csswg.org/css-values-4/#url-value),
- * consumes it, resolves the URL and returns the resulting #GFile.
+ * consumes it, resolves the URL and returns the resulting `GFile`.
* On failure, an error is emitted and %NULL is returned.
*
* Returns: (nullable) (transfer full): the resulting URL
diff --git a/gtk/css/gtkcsssection.c b/gtk/css/gtkcsssection.c
index c0edb7e1ff..5851cc201c 100644
--- a/gtk/css/gtkcsssection.c
+++ b/gtk/css/gtkcsssection.c
@@ -188,7 +188,7 @@ gtk_css_section_get_end_location (const GtkCssSection *section)
/**
* gtk_css_section_print:
* @section: a section
- * @string: a #GString to print to
+ * @string: a `GString` to print to
*
* Prints the `section` into `string` in a human-readable form.
*
@@ -235,7 +235,7 @@ gtk_css_section_print (const GtkCssSection *section,
/**
* gtk_css_section_to_string:
- * @section: a #GtkCssSection
+ * @section: a `GtkCssSection`
*
* Prints the section into a human-readable text form using
* [method@Gtk.CssSection.print].
diff --git a/gtk/css/gtkcsstokenizer.c b/gtk/css/gtkcsstokenizer.c
index 34d29466b1..05fca8ed01 100644
--- a/gtk/css/gtkcsstokenizer.c
+++ b/gtk/css/gtkcsstokenizer.c
@@ -151,7 +151,7 @@ append_string (GString *string,
/*
* gtk_css_token_is_finite:
- * @token: a #GtkCssToken
+ * @token: a `GtkCssToken`
*
* A token is considered finite when it would stay the same no matter
* what bytes follow it in the data stream.
@@ -213,7 +213,7 @@ gtk_css_token_is_finite (const GtkCssToken *token)
/*
* gtk_css_token_is_preserved:
- * @token: a #GtkCssToken
+ * @token: a `GtkCssToken`
* @out_closing: (nullable): Type of the token that closes a block
* started with this token
*