mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-11-10 02:40:11 +00:00
docs: use more apostrophes
This commit is contained in:
parent
7a208fbbf3
commit
f0000b2f3d
@ -324,9 +324,9 @@ typedef enum
|
||||
|
||||
/**
|
||||
* GdkGrabOwnership:
|
||||
* @GDK_OWNERSHIP_NONE: All other devices' events are allowed.
|
||||
* @GDK_OWNERSHIP_WINDOW: Other devices' events are blocked for the grab window.
|
||||
* @GDK_OWNERSHIP_APPLICATION: Other devices' events are blocked for the whole application.
|
||||
* @GDK_OWNERSHIP_NONE: All other devices’ events are allowed.
|
||||
* @GDK_OWNERSHIP_WINDOW: Other devices’ events are blocked for the grab window.
|
||||
* @GDK_OWNERSHIP_APPLICATION: Other devices’ events are blocked for the whole application.
|
||||
*
|
||||
* Defines how device grabs interact with other devices.
|
||||
*/
|
||||
|
@ -103,7 +103,7 @@ struct _GtkUIManagerClass {
|
||||
* @GTK_UI_MANAGER_SEPARATOR: Create a separator.
|
||||
* @GTK_UI_MANAGER_ACCELERATOR: Install an accelerator.
|
||||
* @GTK_UI_MANAGER_POPUP_WITH_ACCELS: Same as %GTK_UI_MANAGER_POPUP, but the
|
||||
* actions' accelerators are shown.
|
||||
* actions’ accelerators are shown.
|
||||
*
|
||||
* These enumeration values are used by gtk_ui_manager_add_ui() to determine
|
||||
* what UI element to create.
|
||||
|
@ -93,7 +93,7 @@
|
||||
* to use a custom cell area with a combo box. But construct properties
|
||||
* 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
|
||||
* 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
|
||||
* construct property value will be ignored (with a warning, to alert
|
||||
* you to the problem).
|
||||
@ -510,7 +510,7 @@ gtk_cell_layout_add_attribute (GtkCellLayout *cell_layout,
|
||||
* Sets the #GtkCellLayoutDataFunc to use for @cell_layout.
|
||||
*
|
||||
* This function is used instead of the standard attributes mapping
|
||||
* for setting the column value, and should set the value of @cell_layout's
|
||||
* for setting the column value, and should set the value of @cell_layout’s
|
||||
* cell renderer(s) as appropriate.
|
||||
*
|
||||
* @func may be %NULL to remove a previously set function.
|
||||
|
@ -173,7 +173,7 @@
|
||||
* color: #39f1f9;
|
||||
* }
|
||||
*
|
||||
* /* Theme spinbuttons' entry */
|
||||
* /* Theme spinbuttons’ entry */
|
||||
* GtkSpinButton.entry {
|
||||
* color: #900185
|
||||
* }
|
||||
|
@ -1575,7 +1575,7 @@ gtk_scale_clear_marks (GtkScale *scale)
|
||||
* gtk_scale_add_mark:
|
||||
* @scale: a #GtkScale
|
||||
* @value: the value at which the mark is placed, must be between
|
||||
* the lower and upper limits of the scales' adjustment
|
||||
* the lower and upper limits of the scales’ adjustment
|
||||
* @position: where to draw the mark. For a horizontal scale, #GTK_POS_TOP
|
||||
* and %GTK_POS_LEFT are drawn above the scale, anything else below.
|
||||
* For a vertical scale, #GTK_POS_LEFT and %GTK_POS_TOP are drawn to
|
||||
|
@ -31,7 +31,7 @@
|
||||
* All scrollable widgets should do the following.
|
||||
*
|
||||
* - When a parent widget sets the scrollable child widget’s adjustments,
|
||||
* the widget should populate the adjustments'
|
||||
* the widget should populate the adjustments’
|
||||
* #GtkAdjustment:lower, #GtkAdjustment:upper,
|
||||
* #GtkAdjustment:step-increment, #GtkAdjustment:page-increment and
|
||||
* #GtkAdjustment:page-size properties and connect to the
|
||||
@ -43,7 +43,7 @@
|
||||
* #GtkWidgetClass.size_allocate() function.
|
||||
*
|
||||
* - When the parent allocates space to the scrollable child widget,
|
||||
* the widget should update the adjustments' properties with new values.
|
||||
* the widget should update the adjustments’ properties with new values.
|
||||
*
|
||||
* - When any of the adjustments emits the #GtkAdjustment::value-changed signal,
|
||||
* the scrollable widget should scroll its contents.
|
||||
|
@ -60,7 +60,7 @@
|
||||
* can be either attached explicitly to the context through
|
||||
* gtk_style_context_add_provider(), or to the screen through
|
||||
* gtk_style_context_add_provider_for_screen(). The resulting style is a
|
||||
* combination of all providers' information in priority order.
|
||||
* combination of all providers’ information in priority order.
|
||||
*
|
||||
* For GTK+ widgets, any #GtkStyleContext returned by
|
||||
* gtk_widget_get_style_context() will already have a #GtkWidgetPath, a
|
||||
@ -230,7 +230,7 @@
|
||||
* to style your UI elements in a different way if needed so.
|
||||
*
|
||||
* If you are using custom styling on an applications, you probably want then
|
||||
* to make your style information prevail to the theme's, so you must use
|
||||
* 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
|
||||
* `XDG_CONFIG_HOME/gtk-3.0/gtk.css` will
|
||||
@ -246,7 +246,7 @@
|
||||
/* When these change we do a full restyling. Otherwise we try to figure out
|
||||
* if we need to change things. */
|
||||
#define GTK_STYLE_CONTEXT_RADICAL_CHANGE (GTK_CSS_CHANGE_NAME | GTK_CSS_CHANGE_CLASS | GTK_CSS_CHANGE_SOURCE)
|
||||
/* When these change we don't clear the cache. This takes more memory but makes
|
||||
/* When these change we don’t clear the cache. This takes more memory but makes
|
||||
* things go faster. */
|
||||
#define GTK_STYLE_CONTEXT_CACHED_CHANGE (GTK_CSS_CHANGE_STATE)
|
||||
|
||||
@ -398,7 +398,7 @@ gtk_style_context_class_init (GtkStyleContextClass *klass)
|
||||
/**
|
||||
* GtkStyleContext:parent:
|
||||
*
|
||||
* Sets or gets the style context's parent. See gtk_style_context_set_parent()
|
||||
* Sets or gets the style context’s parent. See gtk_style_context_set_parent()
|
||||
* for details.
|
||||
*
|
||||
* Since: 3.4
|
||||
@ -1012,9 +1012,9 @@ gtk_style_context_set_invalid (GtkStyleContext *context,
|
||||
}
|
||||
}
|
||||
|
||||
/* returns TRUE if someone called gtk_style_context_save() but hasn't
|
||||
/* returns TRUE if someone called gtk_style_context_save() but hasn’t
|
||||
* called gtk_style_context_restore() yet.
|
||||
* In those situations we don't invalidate the context when somebody
|
||||
* In those situations we don’t invalidate the context when somebody
|
||||
* changes state/regions/classes.
|
||||
*/
|
||||
static gboolean
|
||||
@ -1045,7 +1045,7 @@ gtk_style_context_queue_invalidate_internal (GtkStyleContext *context,
|
||||
* gtk_style_context_new:
|
||||
*
|
||||
* Creates a standalone #GtkStyleContext, this style context
|
||||
* won't be attached to any widget, so you may want
|
||||
* won’t be attached to any widget, so you may want
|
||||
* to call gtk_style_context_set_path() yourself.
|
||||
*
|
||||
* This function is only useful when using the theming layer
|
||||
@ -4372,7 +4372,7 @@ gtk_render_activity (GtkStyleContext *context,
|
||||
* @context: a #GtkStyleContext
|
||||
* @source: the #GtkIconSource specifying the icon to render
|
||||
* @size: (type int): the size to render the icon at. A size of (GtkIconSize) -1
|
||||
* means render at the size of the source and don't scale.
|
||||
* means render at the size of the source and don’t scale.
|
||||
*
|
||||
* Renders the icon specified by @source at the given @size, returning the result
|
||||
* in a pixbuf.
|
||||
|
@ -6167,7 +6167,7 @@ recompute_level_nonzero_counts (GtkTextBTreeNode *node)
|
||||
* Side effects:
|
||||
* The tag counts for node are modified to reflect its current
|
||||
* child structure, as are its num_children, num_lines, num_chars fields.
|
||||
* Also, all of the childrens' parent fields are made to point
|
||||
* Also, all of the childrens’ parent fields are made to point
|
||||
* to node.
|
||||
*
|
||||
*----------------------------------------------------------------------
|
||||
@ -6180,7 +6180,7 @@ recompute_node_counts (GtkTextBTree *tree, GtkTextBTreeNode *node)
|
||||
Summary *summary, *summary2;
|
||||
|
||||
/*
|
||||
* Zero out all the existing counts for the GtkTextBTreeNode, but don't delete
|
||||
* Zero out all the existing counts for the GtkTextBTreeNode, but don’t delete
|
||||
* the existing Summary records (most of them will probably be reused).
|
||||
*/
|
||||
|
||||
@ -6196,8 +6196,8 @@ recompute_node_counts (GtkTextBTree *tree, GtkTextBTreeNode *node)
|
||||
node->num_chars = 0;
|
||||
|
||||
/*
|
||||
* Scan through the children, adding the childrens' tag counts into
|
||||
* the GtkTextBTreeNode's tag counts and adding new Summary structures if
|
||||
* Scan through the children, adding the childrens’ tag counts into
|
||||
* the GtkTextBTreeNode’s tag counts and adding new Summary structures if
|
||||
* necessary.
|
||||
*/
|
||||
|
||||
@ -6214,7 +6214,7 @@ recompute_node_counts (GtkTextBTree *tree, GtkTextBTreeNode *node)
|
||||
}
|
||||
|
||||
/*
|
||||
* Scan through the GtkTextBTreeNode's tag records again and delete any Summary
|
||||
* Scan through the GtkTextBTreeNode’s tag records again and delete any Summary
|
||||
* records that still have a zero count, or that have all the toggles.
|
||||
* The GtkTextBTreeNode with the children that account for all the tags toggles
|
||||
* have no summary information, and they become the tag_root for the tag.
|
||||
@ -6229,7 +6229,7 @@ recompute_node_counts (GtkTextBTree *tree, GtkTextBTreeNode *node)
|
||||
if (node->level == summary->info->tag_root->level)
|
||||
{
|
||||
/*
|
||||
* The tag's root GtkTextBTreeNode split and some toggles left.
|
||||
* The tag’s root GtkTextBTreeNode split and some toggles left.
|
||||
* The tag root must move up a level.
|
||||
*/
|
||||
summary->info->tag_root = node->parent;
|
||||
@ -6287,14 +6287,14 @@ _gtk_change_node_toggle_count (GtkTextBTreeNode *node,
|
||||
|
||||
/*
|
||||
* Iterate over the GtkTextBTreeNode and its ancestors up to the tag root, adjusting
|
||||
* summary counts at each GtkTextBTreeNode and moving the tag's root upwards if
|
||||
* summary counts at each GtkTextBTreeNode and moving the tag’s root upwards if
|
||||
* necessary.
|
||||
*/
|
||||
|
||||
for ( ; node != info->tag_root; node = node->parent)
|
||||
{
|
||||
/*
|
||||
* See if there's already an entry for this tag for this GtkTextBTreeNode. If so,
|
||||
* See if there’s already an entry for this tag for this GtkTextBTreeNode. If so,
|
||||
* perhaps all we have to do is adjust its count.
|
||||
*/
|
||||
|
||||
@ -6319,7 +6319,7 @@ _gtk_change_node_toggle_count (GtkTextBTreeNode *node,
|
||||
{
|
||||
/*
|
||||
* Should never find a GtkTextBTreeNode with max toggle count at this
|
||||
* point (there shouldn't have been a summary entry in the
|
||||
* point (there shouldn’t have been a summary entry in the
|
||||
* first place).
|
||||
*/
|
||||
|
||||
@ -6344,7 +6344,7 @@ _gtk_change_node_toggle_count (GtkTextBTreeNode *node,
|
||||
else
|
||||
{
|
||||
/*
|
||||
* This tag isn't currently in the summary information list.
|
||||
* This tag isn’t currently in the summary information list.
|
||||
*/
|
||||
|
||||
if (rootLevel == node->level)
|
||||
@ -6352,9 +6352,9 @@ _gtk_change_node_toggle_count (GtkTextBTreeNode *node,
|
||||
|
||||
/*
|
||||
* The old tag root is at the same level in the tree as this
|
||||
* GtkTextBTreeNode, but it isn't at this GtkTextBTreeNode. Move the tag root up
|
||||
* GtkTextBTreeNode, but it isn’t at this GtkTextBTreeNode. Move the tag root up
|
||||
* a level, in the hopes that it will now cover this GtkTextBTreeNode
|
||||
* as well as the old root (if not, we'll move it up again
|
||||
* as well as the old root (if not, we’ll move it up again
|
||||
* the next time through the loop). To push it up one level
|
||||
* we copy the original toggle count into the summary
|
||||
* information at the old root and change the root to its
|
||||
@ -6380,7 +6380,7 @@ _gtk_change_node_toggle_count (GtkTextBTreeNode *node,
|
||||
}
|
||||
|
||||
/*
|
||||
* If we've decremented the toggle count, then it may be necessary
|
||||
* If we’ve decremented the toggle count, then it may be necessary
|
||||
* to push the tag root down one or more levels.
|
||||
*/
|
||||
|
||||
@ -6397,7 +6397,7 @@ _gtk_change_node_toggle_count (GtkTextBTreeNode *node,
|
||||
while (node->level > 0)
|
||||
{
|
||||
/*
|
||||
* See if a single child GtkTextBTreeNode accounts for all of the tag's
|
||||
* See if a single child GtkTextBTreeNode accounts for all of the tag’s
|
||||
* toggles. If so, push the root down one level.
|
||||
*/
|
||||
|
||||
@ -6454,7 +6454,7 @@ _gtk_change_node_toggle_count (GtkTextBTreeNode *node,
|
||||
*
|
||||
* This is a utility procedure used by _gtk_text_btree_get_tags. It
|
||||
* increments the count for a particular tag, adding a new
|
||||
* entry for that tag if there wasn't one previously.
|
||||
* entry for that tag if there wasn’t one previously.
|
||||
*
|
||||
* Results:
|
||||
* None.
|
||||
@ -6483,7 +6483,7 @@ inc_count (GtkTextTag *tag, int inc, TagInfo *tagInfoPtr)
|
||||
}
|
||||
|
||||
/*
|
||||
* There isn't currently an entry for this tag, so we have to
|
||||
* There isn’t currently an entry for this tag, so we have to
|
||||
* make a new one. If the arrays are full, then enlarge the
|
||||
* arrays first.
|
||||
*/
|
||||
@ -6667,7 +6667,7 @@ gtk_text_btree_node_view_check_consistency (GtkTextBTree *tree,
|
||||
* nodes.
|
||||
*
|
||||
* The guarantee is that if there are invalid lines the node is
|
||||
* invalid - we don't guarantee that if the node is invalid there
|
||||
* invalid - we don’t guarantee that if the node is invalid there
|
||||
* are invalid lines.
|
||||
*/
|
||||
|
||||
@ -6740,7 +6740,7 @@ gtk_text_btree_node_check_consistency (GtkTextBTree *tree,
|
||||
ld = line->views;
|
||||
while (ld != NULL)
|
||||
{
|
||||
/* Just ensuring we don't segv while doing this loop */
|
||||
/* Just ensuring we don’t segv while doing this loop */
|
||||
|
||||
ld = ld->next;
|
||||
}
|
||||
@ -7054,8 +7054,8 @@ _gtk_text_btree_check (GtkTextBTree *tree)
|
||||
|| (seg->type == >k_text_left_mark_type))
|
||||
{
|
||||
/*
|
||||
* It's OK to toggle a tag off in the last line, but
|
||||
* not to start a new range. It's also OK to have marks
|
||||
* It’s OK to toggle a tag off in the last line, but
|
||||
* not to start a new range. It’s also OK to have marks
|
||||
* in the last line.
|
||||
*/
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user