summaryrefslogtreecommitdiff
path: root/common
diff options
context:
space:
mode:
authorRyan Lortie <desrt@desrt.ca>2013-02-04 12:55:51 +0100
committerRyan Lortie <desrt@desrt.ca>2013-02-11 13:15:37 -0500
commit9d0b53f86371a459615e9872a5b835b917a568ae (patch)
treef3dbfadb45a456f8a600c5ae13f176b29936095c /common
parentbc82ad8e237e0d57ecccbfc3d8175e041aeeab50 (diff)
downloaddconf-9d0b53f86371a459615e9872a5b835b917a568ae.tar.gz
docs/comments: make some corrections/updates
Many fixes for typos but also some adjustments for the recent refactoring (particularly updating HACKING).
Diffstat (limited to 'common')
-rw-r--r--common/dconf-changeset.c11
-rw-r--r--common/dconf-paths.c2
2 files changed, 7 insertions, 6 deletions
diff --git a/common/dconf-changeset.c b/common/dconf-changeset.c
index 639ea89..e6931b0 100644
--- a/common/dconf-changeset.c
+++ b/common/dconf-changeset.c
@@ -47,7 +47,7 @@
* This is a reference counted opaque structure type. It is not a
* #GObject.
*
- * Use dconf_changeset_ref() and dconf_changeset_unref() to manipuate
+ * Use dconf_changeset_ref() and dconf_changeset_unref() to manipulate
* references.
**/
@@ -334,7 +334,7 @@ dconf_changeset_is_similar_to (DConfChangeset *changeset,
* @predicate is called on each item in the changeset, in turn, until it
* returns %FALSE.
*
- * If @preciate returns %FALSE for any item, this function returns
+ * If @predicate returns %FALSE for any item, this function returns
* %FALSE. If not (including the case of no items) then this function
* returns %TRUE.
*
@@ -387,8 +387,9 @@ dconf_changeset_build_description (DConfChangeset *changeset)
* Next, we iterate the table again to pull the strings out excluding
* the leading prefix.
*
- * We sort the list of paths at this point because the rebuilder
- * requires a sorted list.
+ * We sort the list of paths at this point because the writer
+ * requires a sorted list in order to ensure that dir resets come
+ * before writes to keys in that dir.
*
* Finally, we iterate over the sorted list and use the normal
* hashtable lookup in order to populate the values array in the same
@@ -562,7 +563,7 @@ dconf_changeset_serialise (DConfChangeset *changeset)
* returned from an earlier call to dconf_changeset_serialise().
*
* @serialised has no particular format -- you should only pass a value
- * that reasulted from an earlier serialise operation.
+ * that resulted from an earlier serialise operation.
*
* This call never fails, even if @serialised is not in the correct
* format. Improperly-formatted parts are simply ignored.
diff --git a/common/dconf-paths.c b/common/dconf-paths.c
index 33a6f74..70cea5b 100644
--- a/common/dconf-paths.c
+++ b/common/dconf-paths.c
@@ -24,7 +24,7 @@
/**
* SECTION:paths
- * @title: DConf Paths
+ * @title: dconf Paths
* @short_description: utility functions to validate dconf paths
*
* Various places in the dconf API speak of "paths", "keys", "dirs" and