[glib] Apply English pedantry to GAsyncInitable's docs
- From: Alexander Larsson <alexl src gnome org>
- To: svn-commits-list gnome org
- Cc:
- Subject: [glib] Apply English pedantry to GAsyncInitable's docs
- Date: Thu, 26 Nov 2009 14:36:01 +0000 (UTC)
commit 97db31fa14d2556a649d1d66a0dfc1792c5908d7
Author: Will Thompson <will thompson collabora co uk>
Date: Fri Nov 20 13:01:17 2009 +0000
Apply English pedantry to GAsyncInitable's docs
â?¢ "asynchronous" was misspelled as "asyncronous" in various places;
â?¢ punctuation was missing;
â?¢ g_async_initable_new_async() had a stray "and";
â?¢ references to g_async_initable_new_finish() were missing a "the".
https://bugzilla.gnome.org/show_bug.cgi?id=602417
gio/gasyncinitable.c | 38 +++++++++++++++++++-------------------
1 files changed, 19 insertions(+), 19 deletions(-)
---
diff --git a/gio/gasyncinitable.c b/gio/gasyncinitable.c
index e885693..05e17e2 100644
--- a/gio/gasyncinitable.c
+++ b/gio/gasyncinitable.c
@@ -34,14 +34,14 @@
* @include: gio/gio.h
* @see_also: #GInitable
*
- * This is the asynchronous version of #GInitable, it behaves the same
+ * This is the asynchronous version of #GInitable; it behaves the same
* in all ways except that initialization is asynchronous. For more details
* see the descriptions on #GInitable.
*
* A class may implement both the #GInitable and #GAsyncInitable interfaces.
*
* Users of objects implementing this are not intended to use the interface
- * method directly, instead it will be used automatically in various ways.
+ * method directly; instead it will be used automatically in various ways.
* For C applications you generally just call g_async_initable_new_async()
* directly, or indirectly via a foo_thing_new_async() wrapper. This will call
* g_async_initable_init_async() under the cover, calling back with %NULL and
@@ -119,21 +119,21 @@ g_async_initable_base_init (gpointer g_iface)
* Implementations may also support cancellation. If @cancellable is not
* %NULL, then initialization can be cancelled by triggering the cancellable
* object from another thread. If the operation was cancelled, the error
- * %G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL and
- * the object doesn't support cancellable initialization the error
+ * %G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL, and
+ * the object doesn't support cancellable initialization, the error
* %G_IO_ERROR_NOT_SUPPORTED will be returned.
*
- * If this function is not called, or returns with an error then all
+ * If this function is not called, or returns with an error, then all
* operations on the object should fail, generally returning the
* error %G_IO_ERROR_NOT_INITIALIZED.
*
- * Implementations of this method must be idempotent, i.e. multiple calls
+ * Implementations of this method must be idempotent: i.e. multiple calls
* to this function with the same argument should return the same results.
- * Only the first call initializes the object, further calls return the result
- * of the first call. This is so that its safe to implement the singleton
+ * Only the first call initializes the object; further calls return the result
+ * of the first call. This is so that it's safe to implement the singleton
* pattern in the GObject constructor function.
*
- * For classes that also support the #GInitable interface the default
+ * For classes that also support the #GInitable interface, the default
* implementation of this method will run the g_initable_init() function
* in a thread, so if you want to support asynchronous initialization via
* threads, just implement the #GAsyncInitable interface without overriding
@@ -245,15 +245,15 @@ g_async_initable_real_init_finish (GAsyncInitable *initable,
* @user_data: the data to pass to callback function
* @first_property_name: the name of the first property, or %NULL if no
* properties
- * @...: the value if the first property, followed by and other property
+ * @...: the value of the first property, followed by other property
* value pairs, and ended by %NULL.
*
* Helper function for constructing #GAsyncInitiable object. This is
- * similar to g_object_new() but also initializes the object asyncronously.
+ * similar to g_object_new() but also initializes the object asynchronously.
*
* When the initialization is finished, @callback will be called. You can
- * then call g_async_initable_new_finish() to get new object and check for
- * any errors.
+ * then call g_async_initable_new_finish() to get the new object and check
+ * for any errors.
*
* Since: 2.22
*/
@@ -289,11 +289,11 @@ g_async_initable_new_async (GType object_type,
* @user_data: the data to pass to callback function
*
* Helper function for constructing #GAsyncInitiable object. This is
- * similar to g_object_newv() but also initializes the object asyncronously.
+ * similar to g_object_newv() but also initializes the object asynchronously.
*
* When the initialization is finished, @callback will be called. You can
- * then call g_async_initable_new_finish() to get new object and check for
- * any errors.
+ * then call g_async_initable_new_finish() to get the new object and check
+ * for any errors.
*
* Since: 2.22
*/
@@ -332,11 +332,11 @@ g_async_initable_newv_async (GType object_type,
*
* Helper function for constructing #GAsyncInitiable object. This is
* similar to g_object_new_valist() but also initializes the object
- * asyncronously.
+ * asynchronously.
*
* When the initialization is finished, @callback will be called. You can
- * then call g_async_initable_new_finish() to get new object and check for
- * any errors.
+ * then call g_async_initable_new_finish() to get the new object and check
+ * for any errors.
*
* Since: 2.22
*/
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]