Commit 2d003553 authored by William Jon McCann's avatar William Jon McCann
Browse files

docs: don't use <emphasis>

It is a little heavy handed. The text can speak for itself.
parent 5d053e03
......@@ -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
......
......@@ -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.
......
......@@ -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
......
......@@ -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
......
......@@ -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
......
......@@ -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.
*
......
......@@ -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.
*
......
......@@ -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.
......
......@@ -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.
......
......@@ -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
......
......@@ -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
......
......@@ -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
......
......@@ -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
......
......@@ -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.
*
......
......@@ -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.
......
......@@ -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
......
......@@ -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.
**/
......
......@@ -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
......
......@@ -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
......
......@@ -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">
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment