docs: don't use <replaceable>

2014-02-04 19:20:16 -05:00 · 2014-02-04 19:20:16 -05:00 · 8ad75bdfff
commit 8ad75bdfff
parent 5dd751f006
8 changed files with 71 additions and 71 deletions
--- 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
- * `&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable>`.
+ * `&lt;Actions&gt;/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 
- * `&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable>`.  
+ * `&lt;Actions&gt;/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 
- * `&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable>`.  
+ * `&lt;Actions&gt;/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 
- * `&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable>`.  
+ * `&lt;Actions&gt;/group-name/action-name`.  
 * 
 * Since: 2.4
 *
--- a/gtk/deprecated/gtkrc.c
+++ b/gtk/deprecated/gtkrc.c
@ -257,66 +257,66 @@
 *
 * The possible toplevel declarations are:
 *
- * * `binding <replaceable>name</replaceable>
+ * * `binding name
 *      { ... }`
 *
 *    Declares a binding set.
 *
- * * `class <replaceable>pattern</replaceable>
- *           [ style | binding ][ : <replaceable>priority</replaceable> ]
- *           <replaceable>name</replaceable>`
+ * * `class pattern
+ *           [ style | binding ][ : priority ]
+ *           name`
 *
 *    Specifies a style or binding set for a particular
 *      branch of the inheritance hierarchy.
 *
- * * `include <replaceable>filename</replaceable>`
+ * * `include filename`
 *
 *    Parses another file at this point. If
- *         <replaceable>filename</replaceable> 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
 *         <link linkend="locale-specific-rc">locale-specific variant</link> of
 *         the included file.
 *
- * * `module_path <replaceable>path</replaceable>`
+ * * `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 <replaceable>path</replaceable>`
+ * * `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 <replaceable>pathname</replaceable>`
+ * * `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 <replaceable>name</replaceable> [ =
- *     <replaceable>parent</replaceable> ] { ... }`
+ * * `style name [ =
+ *     parent ] { ... }`
 *
 *    Declares a style.
 *
- * * `widget <replaceable>pattern</replaceable>
- *           [ style | binding ][ : <replaceable>priority</replaceable> ]
- *           <replaceable>name</replaceable>`
+ * * `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 <replaceable>pattern</replaceable>
- *           [ style | binding ][ : <replaceable>priority</replaceable> ]
- *           <replaceable>name</replaceable>`
+ * * `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.
 *
- * * <replaceable>setting</replaceable> = <replaceable>value</replaceable>
+ * * setting = value
 *
 *    Specifies a value for a <link linkend="GtkSettings">setting</link>.
 *         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[<replaceable>state</replaceable>] = <replaceable>color</replaceable>`
+ * * `bg[state] = color`
 *
 *   Sets the color used for the background of most widgets.
 *
- * * `fg[<replaceable>state</replaceable>] = <replaceable>color</replaceable>`
+ * * `fg[state] = color`
 *
 *   Sets the color used for the foreground of most widgets.
 *
- * * `base[<replaceable>state</replaceable>] = <replaceable>color</replaceable>`
+ * * `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[<replaceable>state</replaceable>] =
- *       <replaceable>color</replaceable>`
+ * * `text[state] =
+ *       color`
 *
 *          Sets the color used for foreground of widgets using
 *          `base` for the background color.
 *
 * * `xthickness =
- *       <replaceable>number</replaceable>`
+ *       number`
 *
 *          Sets the xthickness, which is used for various horizontal padding
 *          values in GTK+.
 *
 * * `ythickness =
- *       <replaceable>number</replaceable>`
+ *       number`
 *
 *          Sets the ythickness, which is used for various vertical padding
 *          values in GTK+.
 *
- * * `bg_pixmap[<replaceable>state</replaceable>] =
- *       <replaceable>pixmap</replaceable>`
+ * * `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
 *          `"&lt;none&gt;"` may be used to indicate no background pixmap.

- * * `font = <replaceable>font</replaceable>`
+ * * `font = font`
 *
 *          Starting with GTK+ 2.0, the "font" and "fontset"
 *          declarations are ignored; use "font_name" declarations instead.
 *
- * * `fontset = <replaceable>font</replaceable>`
+ * * `fontset = font`
 *
 *          Starting with GTK+ 2.0, the "font" and "fontset"
 *          declarations are ignored; use "font_name" declarations instead.
 *
- * * `font_name = <replaceable>font</replaceable>`
+ * * `font_name = font`
 *
- *          Sets the font for a widget. <replaceable>font</replaceable> 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[<replaceable>"stock-id"</replaceable>] = { <replaceable>icon source specifications</replaceable> }`
+ * * `stock["stock-id"] = { icon source specifications }`
 *
 *         Defines the icon for a stock item.
 *
- * * `color[<replaceable>"color-name"</replaceable>] = <replaceable>color specification</replaceable>`
+ * * `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 <replaceable>"engine"</replaceable> { <replaceable>engine-specific
- * settings</replaceable> }`
+ * * `engine "engine" { engine-specific
+ * settings }`
 *
 *         Defines the engine to be used when drawing with this style.
 *
- * * `<replaceable>class</replaceable>::<replaceable>property</replaceable> = <replaceable>value</replaceable>`
+ * * `class::property = value`
 *
 *         Sets a <link linkend="style-properties">style property</link> 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
- * `{ <replaceable>r</replaceable>, <replaceable>g</replaceable>,
- * <replaceable>b</replaceable>}`, 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 (<replaceable>factor</replaceable>, <replaceable>color1</replaceable>, <replaceable>color2</replaceable>)
+ * * mix (factor, color1, color2)
 *
- *         Computes a new color by mixing <replaceable>color1</replaceable> and
- *         <replaceable>color2</replaceable>. The <replaceable>factor</replaceable>
- *         determines how close the new color is to <replaceable>color1</replaceable>.
- *         A factor of 1.0 gives pure <replaceable>color1</replaceable>, a factor of
- *         0.0 gives pure <replaceable>color2</replaceable>.
+ *         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 (<replaceable>factor</replaceable>, <replaceable>color</replaceable>)
+ * * shade (factor, color)
 *
- *         Computes a lighter or darker variant of <replaceable>color</replaceable>.
- *         A <replaceable>factor</replaceable> 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 (<replaceable>color</replaceable>)
+ * * lighter (color)
 *
 *         This is an abbreviation for
- *         `shade (1.3, <replaceable>color</replaceable>)`.
+ *         `shade (1.3, color)`.
 *
- * * darker (<replaceable>color</replaceable>)
+ * * darker (color)
 *
 *         This is an abbreviation for
- *         `shade (0.7, <replaceable>color</replaceable>)`.
+ *         `shade (0.7, color)`.
 *
 * Here are some examples of color expressions:
 *
@ -569,16 +569,16 @@
 * set declaration is:
 *
 * |[
- * binding <replaceable>name</replaceable> {
- *   bind <replaceable>key</replaceable> {
- *     <replaceable>signalname</replaceable> (<replaceable>param</replaceable>, ...)
+ * binding name {
+ *   bind key {
+ *     signalname (param, ...)
 *     ...
 *   }
 *   ...
 * }
 * ]|
 *
- * <replaceable>key</replaceable> 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:
 *
--- 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::<replaceable>accel_path</replaceable>.
+   * changed::`accel_path`.
   *
   * Since: 2.4
   */
--- 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/<replaceable>theme-name</replaceable>/gtk-3.0/gtk.css`,
+ * `$HOME/.themes/theme-name/gtk-3.0/gtk.css`,
 * falling back to
- * `<replaceable>datadir</replaceable>/share/themes/<replaceable>theme-name</replaceable>/gtk-3.0/gtk.css`,
- * where <replaceable>theme-name</replaceable> is the name of the current theme
- * (see the #GtkSettings:gtk-theme-name setting) and <replaceable>datadir</replaceable>
+ * `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
- * <literallayout>-<replaceable>namespace</replaceable>-<replaceable>name</replaceable></literallayout>, where <replaceable>namespace</replaceable> is typically
- * the name of the theming engine, and <replaceable>name</replaceable> is the
+ * <literallayout>-namespace-name</literallayout>, 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 <replaceable>namespace</replaceable>.
+ * way, using the widget class name for namespace.
 *
 * An example for using engine-specific style properties:
 * |[
--- 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
- *    `<replaceable>programname</replaceable> [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
--- 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:
   *
-   * <replaceable>size-name</replaceable> = <replaceable>width</replaceable> , <replaceable>height</replaceable>
+   * `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,
--- 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
- * `<replaceable>XDG_CONFIG_HOME</replaceable>/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.
 *
--- 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.<replaceable>action-name</replaceable>.
+ * @prefix.`action-name`.
 *
 * If @group is %NULL, a previously inserted group for @name is removed
 * from @widget.