GNOME.org
 

[gtk+] docs: use more apostrophes

commit f0000b2f3d3de91a1814d3e243a0e0a301c9f255
Author: William Jon McCann <william jon mccann gmail com>
Date:   Fri Feb 7 13:26:12 2014 -0500

    docs: use more apostrophes

 gdk/gdktypes.h                |    6 +++---
 gtk/deprecated/gtkuimanager.h |    2 +-
 gtk/gtkcelllayout.c           |    4 ++--
 gtk/gtkcssprovider.c          |    2 +-
 gtk/gtkscale.c                |    2 +-
 gtk/gtkscrollable.c           |    4 ++--
 gtk/gtkstylecontext.c         |   16 ++++++++--------
 gtk/gtktextbtree.c            |   40 ++++++++++++++++++++--------------------
 8 files changed, 38 insertions(+), 38 deletions(-)
---
diff --git a/gdk/gdktypes.h b/gdk/gdktypes.h
index 7b46d24..385996a 100644
--- a/gdk/gdktypes.h
+++ b/gdk/gdktypes.h
@@ -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.
  */
diff --git a/gtk/deprecated/gtkuimanager.h b/gtk/deprecated/gtkuimanager.h
index e37d5a9..714d8ef 100644
--- a/gtk/deprecated/gtkuimanager.h
+++ b/gtk/deprecated/gtkuimanager.h
@@ -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.
diff --git a/gtk/gtkcelllayout.c b/gtk/gtkcelllayout.c
index f485fd8..0f678ce 100644
--- a/gtk/gtkcelllayout.c
+++ b/gtk/gtkcelllayout.c
@@ -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.
diff --git a/gtk/gtkcssprovider.c b/gtk/gtkcssprovider.c
index 2792acf..434fa34 100644
--- a/gtk/gtkcssprovider.c
+++ b/gtk/gtkcssprovider.c
@@ -173,7 +173,7 @@
  *     color: #39f1f9;
  * }
  *
- * /&ast; Theme spinbuttons' entry &ast;/
+ * /&ast; Theme spinbuttons’ entry &ast;/
  * GtkSpinButton.entry {
  *     color: #900185
  * }
diff --git a/gtk/gtkscale.c b/gtk/gtkscale.c
index 5a10401..7f6a4ab 100644
--- a/gtk/gtkscale.c
+++ b/gtk/gtkscale.c
@@ -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
diff --git a/gtk/gtkscrollable.c b/gtk/gtkscrollable.c
index 0c4f67a..68acbed 100644
--- a/gtk/gtkscrollable.c
+++ b/gtk/gtkscrollable.c
@@ -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.
diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c
index c1b51cf..cb63c9e 100644
--- a/gtk/gtkstylecontext.c
+++ b/gtk/gtkstylecontext.c
@@ -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.
diff --git a/gtk/gtktextbtree.c b/gtk/gtktextbtree.c
index bce15e3..925d627 100644
--- a/gtk/gtktextbtree.c
+++ b/gtk/gtktextbtree.c
@@ -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 == &gtk_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.
        */
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]