docs: don't use <emphasis>

It is a little heavy handed. The text can speak for itself.

gdk/gdk.c

@@ -486,7 +486,7 @@ gdk_init (int *argc, char ***argv)
  * like #GtkWidget::button-press-event, do not need thread protection.
  *
  * In particular, this means, if you are writing widgets that might
- * be used in threaded programs, you <emphasis>must</emphasis> surround
+ * be used in threaded programs, you must surround
  * timeouts and idle functions in this matter.
  *
  * As always, you must also surround any calls to GTK+ not made within

gdk/gdkdisplay.c

@@ -55,9 +55,9 @@
  * </itemizedlist>
  *
  * GdkDisplay objects are the GDK representation of an X Display,
- * which can be described as <emphasis>a workstation consisting of
+ * which can be described as a workstation consisting of
  * a keyboard, a pointing device (such as a mouse) and one or more
- * screens</emphasis>.
+ * screens.
  * It is used to open and keep track of various GdkScreen objects
  * currently instantiated by the application. It is also used to
  * access the keyboard(s) and mouse pointer(s) of the display.

gdk/gdkevents.c

@@ -2149,7 +2149,7 @@ gdk_synthesize_window_state (GdkWindow     *window,
  * 
  * Sets the double click time (two clicks within this time interval
  * count as a double click and result in a #GDK_2BUTTON_PRESS event).
- * Applications should <emphasis>not</emphasis> set this, it is a global 
+ * Applications should not set this, it is a global 
  * user-configured setting.
  *
  * Since: 2.2
@@ -2168,7 +2168,7 @@ gdk_display_set_double_click_time (GdkDisplay *display,
  * Set the double click time for the default display. See
  * gdk_display_set_double_click_time(). 
  * See also gdk_display_set_double_click_distance().
- * Applications should <emphasis>not</emphasis> set this, it is a 
+ * Applications should not set this, it is a 
  * global user-configured setting.
  **/
 void
@@ -2185,7 +2185,7 @@ gdk_set_double_click_time (guint msec)
  * Sets the double click distance (two clicks within this distance
  * count as a double click and result in a #GDK_2BUTTON_PRESS event).
  * See also gdk_display_set_double_click_time().
- * Applications should <emphasis>not</emphasis> set this, it is a global 
+ * Applications should not set this, it is a global 
  * user-configured setting.
  *
  * Since: 2.4

gdk/gdkkeys.c

@@ -529,7 +529,7 @@ gdk_keymap_lookup_key (GdkKeymap          *keymap,
  * used in the keymap, since, for instance, <literal>&lt;Control&gt;</literal>
  * would be masked out even if only <literal>&lt;Control&gt;&lt;Alt&gt;</literal>
  * was used in the keymap. To support this usage as well as well as
- * possible, all <emphasis>single modifier</emphasis> combinations
+ * possible, all single modifier combinations
  * that could affect the key for any combination of modifiers will
  * be returned in @consumed_modifiers; multi-modifier combinations
  * are returned only when actually found in @state. When you store

gdk/gdkproperty.c

@@ -44,7 +44,7 @@
  * if they are of different endianesses it will be byteswapped
  * as necessary according to the format of the property.
  * Note that on the client side, properties of format 32
- * will be stored with one unit per <emphasis>long</emphasis>,
+ * will be stored with one unit per long,
  * even if a long integer has more than 32 bits on the platform.
  * (This decision was apparently made for Xlib to maintain
  * compatibility with programs that assumed longs were 32
@@ -208,7 +208,7 @@ gdk_atom_intern (const gchar *atom_name,
  * Note that this function is identical to gdk_atom_intern() except
  * that if a new #GdkAtom is created the string itself is used rather
  * than a copy. This saves memory, but can only be used if the string
- * will <emphasis>always</emphasis> exist. It can be used with statically
+ * will always exist. It can be used with statically
  * allocated strings in the main program, but not with statically
  * allocated memory in dynamically loaded modules, if you expect to
  * ever unload the module again (e.g. do not use this function in

gdk/gdkwindow.c

@@ -6021,7 +6021,7 @@ gdk_window_set_device_cursor (GdkWindow *window,
  * position from the most recent configure event.
  *
  * <note>
- * If @window is not a toplevel, it is <emphasis>much</emphasis> better
+ * If @window is not a toplevel, it is much better
  * to call gdk_window_get_position(), gdk_window_get_width() and
  * gdk_window_get_height() instead, because it avoids the roundtrip to
  * the X server and because these functions support the full 32-bit
@@ -9455,7 +9455,7 @@ gdk_window_set_modal_hint (GdkWindow *window,
  * Toggles whether a window should appear in a task list or window
  * list. If a window's semantic type as specified with
  * gdk_window_set_type_hint() already fully describes the window, this
- * function should <emphasis>not</emphasis> be called in addition,
+ * function should not be called in addition,
  * instead you should allow the window to be treated according to
  * standard policy for its semantic type.
  *
@@ -9478,7 +9478,7 @@ gdk_window_set_skip_taskbar_hint (GdkWindow *window,
  * thumbnail representation of the windows on the desktop). If a
  * window's semantic type as specified with gdk_window_set_type_hint()
  * already fully describes the window, this function should
- * <emphasis>not</emphasis> be called in addition, instead you should
+ * not be called in addition, instead you should
  * allow the window to be treated according to standard policy for
  * its semantic type.
  *

gtk/deprecated/gtkiconfactory.c

@@ -2405,7 +2405,7 @@ gtk_icon_source_set_size (GtkIconSource *source,
  * @source: a #GtkIconSource
  *
  * Obtains the text direction this icon source applies to. The return
- * value is only useful/meaningful if the text direction is <emphasis>not</emphasis>
+ * value is only useful/meaningful if the text direction is not
  * wildcarded.
  *
  * Return value: text direction this source matches
@@ -2425,7 +2425,7 @@ gtk_icon_source_get_direction (const GtkIconSource *source)
  * @source: a #GtkIconSource
  *
  * Obtains the widget state this icon source applies to. The return
- * value is only useful/meaningful if the widget state is <emphasis>not</emphasis>
+ * value is only useful/meaningful if the widget state is not
  * wildcarded.
  *
  * Return value: widget state this source matches
@@ -2445,7 +2445,7 @@ gtk_icon_source_get_state (const GtkIconSource *source)
  * @source: a #GtkIconSource
  *
  * Obtains the icon size this source applies to. The return value
- * is only useful/meaningful if the icon size is <emphasis>not</emphasis> wildcarded.
+ * is only useful/meaningful if the icon size is not wildcarded.
  *
  * Return value: (type int): icon size this source matches.
  *

gtk/deprecated/gtktable.c

@@ -51,11 +51,11 @@
  *
  * To alter the space next to a specific row, use gtk_table_set_row_spacing(),
  * and for a column, gtk_table_set_col_spacing().
- * The gaps between <emphasis>all</emphasis> rows or columns can be changed by
+ * The gaps between all rows or columns can be changed by
  * calling gtk_table_set_row_spacings() or gtk_table_set_col_spacings()
- * respectively. Note that spacing is added <emphasis>between</emphasis> the
- * children, while padding added by gtk_table_attach() is added <emphasis>on
- * either side</emphasis> of the widget it belongs to.
+ * respectively. Note that spacing is added between the
+ * children, while padding added by gtk_table_attach() is added on
+ * either side of the widget it belongs to.
  *
  * gtk_table_set_homogeneous(), can be used to set whether all cells in the
  * table will resize themselves to the size of the largest widget in the table.
@@ -628,7 +628,7 @@ gtk_table_new (guint	rows,
  * @rows: The new number of rows.
  * @columns: The new number of columns.
  *
- * If you need to change a table's size <emphasis>after</emphasis>
+ * If you need to change a table's size after
  * it has been created, this function allows you to do so.
  *
  * Deprecated: 3.4: #GtkGrid resizes automatically.

gtk/gtkbox.c

@@ -35,10 +35,10 @@
  * Thus, all children of a GtkBox are allocated one dimension in common,
  * which is the height of a row, or the width of a column.
  *
- * GtkBox uses a notion of <emphasis>packing</emphasis>. Packing refers
+ * GtkBox uses a notion of packing. Packing refers
  * to adding widgets with reference to a particular position in a
  * #GtkContainer. For a GtkBox, there are two reference positions: the
- * <emphasis>start</emphasis> and the <emphasis>end</emphasis> of the box.
+ * start and the end of the box.
  * For a vertical #GtkBox, the start is defined as the top of the box and
  * the end is defined as the bottom. For a horizontal #GtkBox the start
  * is defined as the left side and the end is defined as the right side.
@@ -58,9 +58,9 @@
  *
  * Use gtk_box_set_spacing() to determine how much space will be
  * minimally placed between all children in the GtkBox. Note that
- * spacing is added <emphasis>between</emphasis> the children, while
+ * spacing is added between the children, while
  * padding added by gtk_box_pack_start() or gtk_box_pack_end() is added
- * <emphasis>on either side</emphasis> of the widget it belongs to.
+ * on either side of the widget it belongs to.
  *
  * Use gtk_box_reorder_child() to move a GtkBox child to a different
  * place in the box.

gtk/gtkcellarea.c

@@ -329,7 +329,7 @@
  * <refsect2 id="cell-properties">
  * <title>Cell Properties</title>
  * <para>
- * The #GtkCellArea introduces <emphasis>cell properties</emphasis>
+ * The #GtkCellArea introduces cell properties
  * for #GtkCellRenderers in very much the same way that #GtkContainer
  * introduces <link linkend="child-properties">child properties</link>
  * for #GtkWidgets. This provides some general interfaces for defining

gtk/gtkcellareabox.c

@@ -29,10 +29,10 @@
  * The #GtkCellAreaBox renders cell renderers into a row or a column
  * depending on its #GtkOrientation.
  *
- * GtkCellAreaBox uses a notion of <emphasis>packing</emphasis>. Packing
+ * GtkCellAreaBox uses a notion of packing. Packing
  * refers to adding cell renderers with reference to a particular position
  * in a #GtkCellAreaBox. There are two reference positions: the
- * <emphasis>start</emphasis> and the <emphasis>end</emphasis> of the box.
+ * start and the end of the box.
  * When the #GtkCellAreaBox is oriented in the %GTK_ORIENTATION_VERTICAL
  * orientation, the start is defined as the top of the box and the end is
  * defined as the bottom. In the %GTK_ORIENTATION_HORIZONTAL orientation

gtk/gtkcelllayout.c

@@ -25,7 +25,7 @@
  * attributes and data funcs.
  *
  * One of the notable features provided by implementations of GtkCellLayout
- * are <emphasis>attributes</emphasis>. Attributes let you set the properties
+ * are attributes. Attributes let you set the properties
  * in flexible ways. They can just be set to constant values like regular
  * properties. But they can also be mapped to a column of the underlying
  * tree model with gtk_cell_layout_set_attributes(), which means that the value
@@ -94,7 +94,7 @@
  * combo = g_object_new (GTK_TYPE_COMBO_BOX, "cell-area", my_cell_area, NULL);
  * </programlisting></informalexample>
  * to use a custom cell area with a combo box. But construct properties
- * are only initialized <emphasis>after</emphasis> instance init()
+ * are only initialized after instance init()
  * functions have run, which means that using functions which rely on
  * the existence of the cell area in your subclass' init() function will
  * cause the default cell area to be instantiated. In this case, a provided

gtk/gtkcellrenderercombo.c

@@ -137,7 +137,7 @@ gtk_cell_renderer_combo_class_init (GtkCellRendererComboClass *klass)
    * combo box. 
    *
    * Note that this refers to the model specified in the model property, 
-   * <emphasis>not</emphasis> the model backing the tree view to which 
+   * not the model backing the tree view to which 
    * this cell renderer is attached.
    * 
    * #GtkCellRendererCombo automatically adds a text cell renderer for 

gtk/gtkcolorbutton.c

@@ -245,7 +245,7 @@ gtk_color_button_class_init (GtkColorButtonClass *klass)
    * When handling this signal, use gtk_color_button_get_rgba() to
    * find out which color was just selected.
    *
-   * Note that this signal is only emitted when the <emphasis>user</emphasis>
+   * Note that this signal is only emitted when the user
    * changes the color. If you need to react to programmatic color changes
    * as well, use the notify::color signal.
    *

gtk/gtkcontainer.c

@@ -67,13 +67,13 @@
  * of the abstract GtkContainer base class.
  *
  * The first type of container widget has a single child widget and derives
- * from #GtkBin. These containers are <emphasis>decorators</emphasis>, which
+ * from #GtkBin. These containers are decorators, which
  * add some kind of functionality to the child. For example, a #GtkButton makes
  * its child into a clickable button; a #GtkFrame draws a frame around its child
  * and a #GtkWindow places its child widget inside a top-level window.
  *
  * The second type of container can have more than one child; its purpose is to
- * manage <emphasis>layout</emphasis>. This means that these containers assign
+ * manage layout. This means that these containers assign
  * sizes and positions to their children. For example, a #GtkHBox arranges its
  * children in a horizontal row, and a #GtkGrid arranges the widgets it contains
  * in a two-dimensional grid.
@@ -185,7 +185,7 @@
  * <refsect2 id="child-properties">
  * <title>Child properties</title>
  * <para>
- * GtkContainer introduces <emphasis>child properties</emphasis>.
+ * GtkContainer introduces child properties.
  * These are object properties that are not specific
  * to either the container or the contained widget, but rather to their relation.
  * Typical examples of child properties are the position or pack-type of a widget
@@ -1458,7 +1458,7 @@ gtk_container_get_property (GObject         *object,
 /**
  * gtk_container_set_border_width:
  * @container: a #GtkContainer
- * @border_width: amount of blank space to leave <emphasis>outside</emphasis>
+ * @border_width: amount of blank space to leave outside
  *   the container. Valid values are in the range 0-65535 pixels.
  *
  * Sets the border width of the container.

gtk/gtkdialog.c

@@ -1244,7 +1244,7 @@ run_destroy_handler (GtkDialog *dialog, gpointer data)
  * Note that even though the recursive main loop gives the effect of a
  * modal dialog (it prevents the user from interacting with other
  * windows in the same window group while the dialog is run), callbacks
- * such as timeouts, IO channel watches, DND drops, etc, <emphasis>will</emphasis>
+ * such as timeouts, IO channel watches, DND drops, etc, will
  * be triggered during a gtk_dialog_run() call.
  *
  * Return value: response ID

gtk/gtkentry.c

@@ -7857,7 +7857,7 @@ gtk_entry_get_activates_default (GtkEntry *entry)
  *
  * Changes the size request of the entry to be about the right size
  * for @n_chars characters. Note that it changes the size
- * <emphasis>request</emphasis>, the size can still be affected by
+ * request, the size can still be affected by
  * how you pack the widget into containers. If @n_chars is -1, the
  * size reverts to the default entry size.
  **/

gtk/gtkfilechooser.c

@@ -75,7 +75,7 @@
  * #GtkFileChooser, your program can get the selected names
  * either as filenames or as URIs.  For URIs, the normal escaping
  * rules are applied if the URI contains non-ASCII characters.
- * However, filenames are <emphasis>always</emphasis> returned in
+ * However, filenames are always returned in
  * the character set specified by the
  * <envar>G_FILENAME_ENCODING</envar> environment variable.
  * Please see the GLib documentation for more details about this
@@ -944,7 +944,7 @@ gtk_file_chooser_set_current_folder (GtkFileChooser *chooser,
  * See gtk_file_chooser_set_current_folder().
  *
  * Note that this is the folder that the file chooser is currently displaying
- * (e.g. "/home/username/Documents"), which is <emphasis>not the same</emphasis>
+ * (e.g. "/home/username/Documents"), which is not the same
  * as the currently-selected folder if the chooser is in
  * %GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER mode
  * (e.g. "/home/username/Documents/selected-folder/".  To get the
@@ -1290,7 +1290,7 @@ gtk_file_chooser_set_current_folder_uri (GtkFileChooser *chooser,
  * See gtk_file_chooser_set_current_folder_uri().
  *
  * Note that this is the folder that the file chooser is currently displaying
- * (e.g. "file:///home/username/Documents"), which is <emphasis>not the same</emphasis>
+ * (e.g. "file:///home/username/Documents"), which is not the same
  * as the currently-selected folder if the chooser is in
  * %GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER mode
  * (e.g. "file:///home/username/Documents/selected-folder/".  To get the

gtk/gtkfilechooserbutton.c

@@ -392,7 +392,7 @@ gtk_file_chooser_button_class_init (GtkFileChooserButtonClass * class)
    *
    * The ::file-set signal is emitted when the user selects a file.
    *
-   * Note that this signal is only emitted when the <emphasis>user</emphasis>
+   * Note that this signal is only emitted when the user
    * changes the file.
    *
    * Since: 2.12

gtk/gtkfilechooserdialog.c

@@ -141,7 +141,7 @@
  * should only cause the file chooser to show a specific folder
  * when it is appropriate to use gtk_file_chooser_set_filename(),
  * i.e. when you are doing a <guimenuitem>File/Save
- * As</guimenuitem> command <emphasis>and</emphasis> you already
+ * As</guimenuitem> command and you already
  * have a file saved somewhere.
  * </para>
  * </note>
@@ -169,7 +169,7 @@
  * boxes you can use your own custom response codes rather than the
  * ones in #GtkResponseType, but #GtkFileChooserDialog assumes that
  * its "accept"-type action, e.g. an "Open" or "Save" button,
- * <emphasis>will</emphasis> have one of the following response
+ * will have one of the following response
  * codes:
  * <para>
  * <simplelist id="gtkfilechooserdialog-responses">