Skip to content
GitLab
Projects
Groups
Snippets
/
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Menu
Open sidebar
GNOME
gtk
Commits
2d003553
Commit
2d003553
authored
Jan 28, 2014
by
William Jon McCann
Browse files
docs: don't use <emphasis>
It is a little heavy handed. The text can speak for itself.
parent
5d053e03
Changes
38
Hide whitespace changes
Inline
Side-by-side
gdk/gdk.c
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -529,7 +529,7 @@ gdk_keymap_lookup_key (GdkKeymap *keymap,
* used in the keymap, since, for instance, <literal><Control></literal>
* would be masked out even if only <literal><Control><Alt></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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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
View file @
2d003553
...
...
@@ -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">
...
...
Prev
1
2
Next
Write
Preview
Supports
Markdown
0%
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment