Stop using replaceable tags

gio/gfileattribute.c

@@ -207,9 +207,9 @@
  * "xattr::". Keys for the "xattr-sys" namespace are constructed by
  * concatenating "xattr-sys::" with the extended attribute name. All extended
  * attribute values are returned as hex-encoded strings in which bytes outside
- * the ASCII range are encoded as hexadecimal escape sequences of the form
+ * the ASCII range are encoded as escape sequences of the form \x`nn`
- * \x<replaceable>nn</replaceable>.
+ * where `nn` is a 2-digit hexadecimal number.
- **/
+ */
 
 /*
  * _g_file_attribute_value_free:

gio/gsettings.c

@@ -2172,11 +2172,11 @@ g_settings_is_writable (GSettings   *settings,
 /**
  * g_settings_get_child:
  * @settings: a #GSettings object
- * @name: the name of the 'child' schema
+ * @name: the name of the child schema
  *
- * Creates a 'child' settings object which has a base path of
+ * Creates a child settings object which has a base path of
- * <replaceable>base-path</replaceable>/@name, where
+ * `base-path/@name`, where `base-path` is the base path of
- * <replaceable>base-path</replaceable> is the base path of @settings.
+ * @settings.
  *
  * The schema for the child settings object must have been declared
  * in the schema of @settings using a &lt;child&gt; element.

glib/goption.c

@@ -52,11 +52,9 @@
  * Another important feature of GOption is that it can automatically
  * generate nicely formatted help output. Unless it is explicitly turned
  * off with g_option_context_set_help_enabled(), GOption will recognize
- * the `--help`, `-?`, `--help-all` and
+ * the `--help`, `-?`, `--help-all` and `--help-groupname` options
- * `--help-`<replaceable>groupname</replaceable> options
+ * (where `groupname` is the name of a #GOptionGroup) and write a text
- * (where <replaceable>groupname</replaceable> is the name of a
+ * similar to the one shown in the following example to stdout.
- * #GOptionGroup) and write a text similar to the one shown in the
- * following example to stdout.
  *
  * |[
  * Usage:
@@ -325,9 +323,8 @@ G_DEFINE_QUARK (g-option-context-error-quark, g_option_error)
 /**
  * g_option_context_new:
  * @parameter_string: (allow-none): a string which is displayed in
- *    the first line of `--help` output, after the
+ *    the first line of `--help` output, after the usage summary
- *    usage summary
+ *    `programname [OPTION...]`
- *    `<replaceable>programname</replaceable> [OPTION...]`
  *
  * Creates a new option context.
  *
@@ -409,11 +406,10 @@ void g_option_context_free (GOptionContext *context)
  * @context: a #GOptionContext
  * @help_enabled: %TRUE to enable `--help`, %FALSE to disable it
  *
- * Enables or disables automatic generation of `--help`
+ * Enables or disables automatic generation of `--help` output.
- * output. By default, g_option_context_parse() recognizes
+ * By default, g_option_context_parse() recognizes `--help`, `-h`,
- * `--help`, `-h`, `-?`, `--help-all`
+ * `-?`, `--help-all` and `--help-groupname` and creates suitable
- * and `--help-`<replaceable>groupname</replaceable> and creates
+ * output to stdout.
- * suitable output to stdout.
  *
  * Since: 2.6
  */

glib/gtestutils.c

@@ -1453,11 +1453,9 @@ g_test_get_root (void)
  *
  * Runs all tests under the toplevel suite which can be retrieved
  * with g_test_get_root(). Similar to g_test_run_suite(), the test
- * cases to be run are filtered according to
+ * cases to be run are filtered according to test path arguments
- * test path arguments (-p <replaceable>testpath</replaceable>) as 
+ * (`-p testpath`) as parsed by g_test_init(). g_test_run_suite()
- * parsed by g_test_init().
+ * or g_test_run() may only be called once in a program.
- * g_test_run_suite() or g_test_run() may only be called once
- * in a program.
  *
  * In general, the tests and sub-suites within each suite are run in
  * the order in which they are defined. However, note that prior to
@@ -2144,9 +2142,9 @@ g_test_run_suite_internal (GTestSuite *suite,
  *
  * Execute the tests within @suite and all nested #GTestSuites.
  * The test suites to be executed are filtered according to
- * test path arguments (-p <replaceable>testpath</replaceable>) 
+ * test path arguments (`-p testpath`) as parsed by g_test_init().
- * as parsed by g_test_init(). See the g_test_run() documentation
+ * See the g_test_run() documentation for more information on the
- * for more information on the order that tests are run in.
+ * order that tests are run in.
  *
  * g_test_run_suite() or g_test_run() may only be called once
  * in a program.