diff --git a/gtk/deprecated/gtkactiongroup.c b/gtk/deprecated/gtkactiongroup.c
index 22f9427391..0664ea66ec 100644
--- a/gtk/deprecated/gtkactiongroup.c
+++ b/gtk/deprecated/gtkactiongroup.c
@@ -965,7 +965,7 @@ gtk_action_group_add_action (GtkActionGroup *action_group,
* with the stock_id of the action.
*
* Accel paths are set to
- * `<Actions>/group-name/action-name`.
+ * `<Actions>/group-name/action-name`.
*
* Since: 2.4
*
@@ -1110,7 +1110,7 @@ gtk_action_group_list_actions (GtkActionGroup *action_group)
*
* The "activate" signals of the actions are connected to the callbacks and
* their accel paths are set to
- * `<Actions>/group-name/action-name`.
+ * `<Actions>/group-name/action-name`.
*
* Since: 2.4
*
@@ -1245,7 +1245,7 @@ gtk_action_group_add_actions_full (GtkActionGroup *action_group,
*
* The "activate" signals of the actions are connected to the callbacks and
* their accel paths are set to
- * `<Actions>/group-name/action-name`.
+ * `<Actions>/group-name/action-name`.
*
* Since: 2.4
*
@@ -1365,7 +1365,7 @@ gtk_action_group_add_toggle_actions_full (GtkActionGroup *action_gro
*
* The "changed" signal of the first radio action is connected to the
* @on_change callback and the accel paths of the actions are set to
- * `<Actions>/group-name/action-name`.
+ * `<Actions>/group-name/action-name`.
*
* Since: 2.4
*
diff --git a/gtk/deprecated/gtkrc.c b/gtk/deprecated/gtkrc.c
index c6aac5f00c..5cf123f654 100644
--- a/gtk/deprecated/gtkrc.c
+++ b/gtk/deprecated/gtkrc.c
@@ -257,66 +257,66 @@
*
* The possible toplevel declarations are:
*
- * * `binding name
+ * * `binding name
* { ... }`
*
* Declares a binding set.
*
- * * `class pattern
- * [ style | binding ][ : priority ]
- * name`
+ * * `class pattern
+ * [ style | binding ][ : priority ]
+ * name`
*
* Specifies a style or binding set for a particular
* branch of the inheritance hierarchy.
*
- * * `include filename`
+ * * `include filename`
*
* Parses another file at this point. If
- * filename is not an absolute filename,
+ * filename is not an absolute filename,
* it is searched in the directories of the currently open RC files.
*
* GTK+ also tries to load a
* locale-specific variant of
* the included file.
*
- * * `module_path path`
+ * * `module_path path`
*
* Sets a path (a list of directories separated
* by colons) that will be searched for theme engines referenced in
* RC files.
*
- * * `pixmap_path path`
+ * * `pixmap_path path`
*
* Sets a path (a list of directories separated
* by colons) that will be searched for pixmaps referenced in
* RC files.
*
- * * `im_module_file pathname`
+ * * `im_module_file pathname`
*
* Sets the pathname for the IM modules file. Setting this from RC files
* is deprecated; you should use the environment variable `GTK_IM_MODULE_FILE`
* instead.
*
- * * `style name [ =
- * parent ] { ... }`
+ * * `style name [ =
+ * parent ] { ... }`
*
* Declares a style.
*
- * * `widget pattern
- * [ style | binding ][ : priority ]
- * name`
+ * * `widget pattern
+ * [ style | binding ][ : priority ]
+ * name`
*
* Specifies a style or binding set for a particular
* group of widgets by matching on the widget pathname.
*
- * * `widget_class pattern
- * [ style | binding ][ : priority ]
- * name`
+ * * `widget_class pattern
+ * [ style | binding ][ : priority ]
+ * name`
*
* Specifies a style or binding set for a particular
* group of widgets by matching on the class pathname.
*
- * * setting = value
+ * * setting = value
*
* Specifies a value for a setting.
* Note that settings in RC files are overwritten by system-wide settings
@@ -338,40 +338,40 @@
* Within a `style` declaration, the possible
* elements are:
*
- * * `bg[state] = color`
+ * * `bg[state] = color`
*
* Sets the color used for the background of most widgets.
*
- * * `fg[state] = color`
+ * * `fg[state] = color`
*
* Sets the color used for the foreground of most widgets.
*
- * * `base[state] = color`
+ * * `base[state] = color`
*
* Sets the color used for the background of widgets displaying
* editable text. This color is used for the background
* of, among others, #GtkText, #GtkEntry, #GtkList, and #GtkCList.
*
- * * `text[state] =
- * color`
+ * * `text[state] =
+ * color`
*
* Sets the color used for foreground of widgets using
* `base` for the background color.
*
* * `xthickness =
- * number`
+ * number`
*
* Sets the xthickness, which is used for various horizontal padding
* values in GTK+.
*
* * `ythickness =
- * number`
+ * number`
*
* Sets the ythickness, which is used for various vertical padding
* values in GTK+.
*
- * * `bg_pixmap[state] =
- * pixmap`
+ * * `bg_pixmap[state] =
+ * pixmap`
*
* Sets a background pixmap to be used in place of
* the `bg` color (or for #GtkText,
@@ -380,38 +380,38 @@
* use the same background pixmap as its parent. The special value
* `"<none>"` may be used to indicate no background pixmap.
- * * `font = font`
+ * * `font = font`
*
* Starting with GTK+ 2.0, the "font" and "fontset"
* declarations are ignored; use "font_name" declarations instead.
*
- * * `fontset = font`
+ * * `fontset = font`
*
* Starting with GTK+ 2.0, the "font" and "fontset"
* declarations are ignored; use "font_name" declarations instead.
*
- * * `font_name = font`
+ * * `font_name = font`
*
- * Sets the font for a widget. font must be
+ * Sets the font for a widget. font must be
* a Pango font name, e.g. `"Sans Italic 10"`.
* For details about Pango font names, see
* pango_font_description_from_string().
*
- * * `stock["stock-id"] = { icon source specifications }`
+ * * `stock["stock-id"] = { icon source specifications }`
*
* Defines the icon for a stock item.
*
- * * `color["color-name"] = color specification`
+ * * `color["color-name"] = color specification`
*
* Since 2.10, this element can be used to defines symbolic colors. See below for
* the syntax of color specifications.
*
- * * `engine "engine" { engine-specific
- * settings }`
+ * * `engine "engine" { engine-specific
+ * settings }`
*
* Defines the engine to be used when drawing with this style.
*
- * * `class::property = value`
+ * * `class::property = value`
*
* Sets a style property for a widget class.
*
@@ -457,8 +457,8 @@
* or `#rgb`, where `r`,
* `g` and `b` are
* hex digits, or they can be specified as a triplet
- * `{ r, g,
- * b}`, where `r`,
+ * `{ r, g,
+ * b}`, where `r`,
* `g` and `b` are either integers in
* the range 0-65535 or floats in the range 0.0-1.0.
*
@@ -466,29 +466,29 @@
* follows: `@color-name`, or by using expressions to combine
* colors. The following expressions are currently supported:
*
- * * mix (factor, color1, color2)
+ * * mix (factor, color1, color2)
*
- * Computes a new color by mixing color1 and
- * color2. The factor
- * determines how close the new color is to color1.
- * A factor of 1.0 gives pure color1, a factor of
- * 0.0 gives pure color2.
+ * Computes a new color by mixing color1 and
+ * color2. The factor
+ * determines how close the new color is to color1.
+ * A factor of 1.0 gives pure color1, a factor of
+ * 0.0 gives pure color2.
*
- * * shade (factor, color)
+ * * shade (factor, color)
*
- * Computes a lighter or darker variant of color.
- * A factor of 1.0 leaves the color unchanged, smaller
+ * Computes a lighter or darker variant of color.
+ * A factor of 1.0 leaves the color unchanged, smaller
* factors yield darker colors, larger factors yield lighter colors.
*
- * * lighter (color)
+ * * lighter (color)
*
* This is an abbreviation for
- * `shade (1.3, color)`.
+ * `shade (1.3, color)`.
*
- * * darker (color)
+ * * darker (color)
*
* This is an abbreviation for
- * `shade (0.7, color)`.
+ * `shade (0.7, color)`.
*
* Here are some examples of color expressions:
*
@@ -569,16 +569,16 @@
* set declaration is:
*
* |[
- * binding name {
- * bind key {
- * signalname (param, ...)
+ * binding name {
+ * bind key {
+ * signalname (param, ...)
* ...
* }
* ...
* }
* ]|
*
- * key is a string consisting of a
+ * `key` is a string consisting of a
* series of modifiers followed by the name of a key. The
* modifiers can be:
*
diff --git a/gtk/gtkaccelmap.c b/gtk/gtkaccelmap.c
index b7645331f8..c62753a9ca 100644
--- a/gtk/gtkaccelmap.c
+++ b/gtk/gtkaccelmap.c
@@ -1005,7 +1005,7 @@ gtk_accel_map_class_init (GtkAccelMapClass *accel_map_class)
* Notifies of a change in the global accelerator map.
* The path is also used as the detail for the signal,
* so it is possible to connect to
- * changed::accel_path.
+ * changed::`accel_path`.
*
* Since: 2.4
*/
diff --git a/gtk/gtkcssprovider.c b/gtk/gtkcssprovider.c
index 1d1805cdb3..fb4947a0e8 100644
--- a/gtk/gtkcssprovider.c
+++ b/gtk/gtkcssprovider.c
@@ -63,11 +63,11 @@
* In addition, certain files will be read when GTK+ is initialized. First,
* the file `$XDG_CONFIG_HOME/gtk-3.0/gtk.css`
* is loaded if it exists. Then, GTK+ tries to load
- * `$HOME/.themes/theme-name/gtk-3.0/gtk.css`,
+ * `$HOME/.themes/theme-name/gtk-3.0/gtk.css`,
* falling back to
- * `datadir/share/themes/theme-name/gtk-3.0/gtk.css`,
- * where theme-name is the name of the current theme
- * (see the #GtkSettings:gtk-theme-name setting) and datadir
+ * `datadir/share/themes/theme-name/gtk-3.0/gtk.css`,
+ * where theme-name is the name of the current theme
+ * (see the #GtkSettings:gtk-theme-name setting) and datadir
* is the prefix configured when GTK+ was compiled, unless overridden by the
* `GTK_DATA_PREFIX` environment variable.
*
@@ -894,11 +894,11 @@
* GtkThemingEngines can register their own, engine-specific style properties
* with the function gtk_theming_engine_register_property(). These properties
* can be set in CSS like other properties, using a name of the form
- * -namespace-name, where namespace is typically
- * the name of the theming engine, and name is the
+ * -namespace-name, where namespace is typically
+ * the name of the theming engine, and name is the
* name of the property. Style properties that have been registered by widgets
* using gtk_widget_class_install_style_property() can also be set in this
- * way, using the widget class name for namespace.
+ * way, using the widget class name for namespace.
*
* An example for using engine-specific style properties:
* |[
diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c
index 1058d33b56..91766c8aea 100644
--- a/gtk/gtkmain.c
+++ b/gtk/gtkmain.c
@@ -841,7 +841,7 @@ gtk_get_option_group (gboolean open_default_display)
* understood by GTK+ are stripped before return.
* @parameter_string: (allow-none): a string which is displayed in
* the first line of `--help` output, after
- * `programname [OPTION...]`
+ * `programname [OPTION...]`
* @entries: (array zero-terminated=1): a %NULL-terminated array
* of #GOptionEntrys describing the options of your program
* @translation_domain: a translation domain to use for translating
diff --git a/gtk/gtksettings.c b/gtk/gtksettings.c
index d04a10a2fd..25f39499dc 100644
--- a/gtk/gtksettings.c
+++ b/gtk/gtksettings.c
@@ -515,7 +515,7 @@ gtk_settings_class_init (GtkSettingsClass *class)
* A list of icon sizes. The list is separated by colons, and
* item has the form:
*
- * size-name = width , height
+ * `size-name` = `width` , `height`
*
* E.g. "gtk-menu=16,16:gtk-button=20,20:gtk-dialog=48,48".
* GTK+ itself use the following named icon sizes: gtk-menu,
diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c
index 11cd25da89..b42dc64d81 100644
--- a/gtk/gtkstylecontext.c
+++ b/gtk/gtkstylecontext.c
@@ -231,7 +231,7 @@
* to make your style information prevail to the theme's, so you must use
* a #GtkStyleProvider with the %GTK_STYLE_PROVIDER_PRIORITY_APPLICATION
* priority, keep in mind that the user settings in
- * `XDG_CONFIG_HOME/gtk-3.0/gtk.css` will
+ * `XDG_CONFIG_HOME/gtk-3.0/gtk.css` will
* still take precedence over your changes, as it uses the
* %GTK_STYLE_PROVIDER_PRIORITY_USER priority.
*
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 6718eae95d..1c55a4a7bf 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -15703,7 +15703,7 @@ _gtk_widget_get_action_muxer (GtkWidget *widget)
* Inserts @group into @widget. Children of @widget that implement
* #GtkActionable can then be associated with actions in @group by
* setting their 'action-name' to
- * @prefix.action-name.
+ * @prefix.`action-name`.
*
* If @group is %NULL, a previously inserted group for @name is removed
* from @widget.