qulogic/pidgin

a06ade737f26
Parents 252bb96afbe0
Children 77536a48b4be
facebook: fixed grammar errors in the GTK-Doc
--- a/libpurple/protocols/facebook/http.h Tue Dec 15 22:35:05 2015 -0500
+++ b/libpurple/protocols/facebook/http.h Wed Dec 16 14:04:26 2015 -0500
@@ -75,7 +75,7 @@
/**
* fb_http_error_chk:
* @res: The #PurpleHttpResponse.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Checks a #PurpleHttpResponse for success. This optionally assigns an
* appropriate #GError upon failure.
@@ -142,7 +142,7 @@
* fb_http_params_get_bool:
* @params: The #FbHttpParams.
* @name: The parameter name.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Gets a boolean value from the #FbHttpParams. This optionally assigns
* an appropriate #GError upon failure.
@@ -157,7 +157,7 @@
* fb_http_params_get_dbl:
* @params: The #FbHttpParams.
* @name: The parameter name.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Gets a floating point value from the #FbHttpParams. This optionally
* assigns an appropriate #GError upon failure.
@@ -172,7 +172,7 @@
* fb_http_params_get_int:
* @params: The #FbHttpParams.
* @name: The parameter name.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Gets an integer value from the #FbHttpParams. This optionally
* assigns an appropriate #GError upon failure.
@@ -187,7 +187,7 @@
* fb_http_params_get_str:
* @params: The #FbHttpParams.
* @name: The parameter name.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Gets a string value from the #FbHttpParams. This optionally assigns
* an appropriate #GError upon failure.
@@ -202,7 +202,7 @@
* fb_http_params_dup_str:
* @params: The #FbHttpParams.
* @name: The parameter name.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Gets a duplicated string value from the #FbHttpParams. This
* optionally assigns an appropriate #GError upon failure. The returned
--- a/libpurple/protocols/facebook/json.h Tue Dec 15 22:35:05 2015 -0500
+++ b/libpurple/protocols/facebook/json.h Wed Dec 16 14:04:26 2015 -0500
@@ -167,7 +167,7 @@
/**
* fb_json_bldr_arr_begin:
* @bldr: The #JsonBuilder.
- * @name: The member name, or #NULL.
+ * @name: The member name or #NULL.
*
* Begins an array member in the #JsonBuilder.
*/
@@ -186,7 +186,7 @@
/**
* fb_json_bldr_obj_begin:
* @bldr: The #JsonBuilder.
- * @name: The member name, or #NULL.
+ * @name: The member name or #NULL.
*
* Begins an object member in the #JsonBuilder.
*/
@@ -205,7 +205,7 @@
/**
* fb_json_bldr_add_bool:
* @bldr: The #JsonBuilder.
- * @name: The member name, or #NULL.
+ * @name: The member name or #NULL.
* @value: The value.
*
* Adds a boolean memeber to the #JsonBuilder.
@@ -216,7 +216,7 @@
/**
* fb_json_bldr_add_dbl:
* @bldr: The #JsonBuilder.
- * @name: The member name, or #NULL.
+ * @name: The member name or #NULL.
* @value: The value.
*
* Adds a floating point memeber to the #JsonBuilder.
@@ -227,7 +227,7 @@
/**
* fb_json_bldr_add_int:
* @bldr: The #JsonBuilder.
- * @name: The member name, or #NULL.
+ * @name: The member name or #NULL.
* @value: The value.
*
* Adds a integer memeber to the #JsonBuilder.
@@ -238,7 +238,7 @@
/**
* fb_json_bldr_add_str:
* @bldr: The #JsonBuilder.
- * @name: The member name, or #NULL.
+ * @name: The member name or #NULL.
* @value: The value.
*
* Adds a string memeber to the #JsonBuilder.
@@ -249,7 +249,7 @@
/**
* fb_json_bldr_add_strf:
* @bldr: The #JsonBuilder.
- * @name: The member name, or #NULL.
+ * @name: The member name or #NULL.
* @format: The format string literal.
* @...: The arguments for @format.
*
@@ -263,8 +263,8 @@
/**
* fb_json_node_new:
* @data: The string JSON.
- * @size: The size of @json, or -1 if null-terminated.
- * @error: The return location for the #GError, or #NULL.
+ * @size: The size of @json or -1 if null-terminated.
+ * @error: The return location for the #GError or #NULL.
*
* Creates a new #JsonNode. The returned #JsonBuilder should be freed
* wuth #json_node_free() when no longer needed.
@@ -278,7 +278,7 @@
* fb_json_node_get:
* @root: The root #JsonNode.
* @expr: The #JsonPath expression.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Gets a new #JsonNode value from a parent #JsonNode with a #JsonPath
* expression. The returned #JsonNode should be freed with
@@ -306,7 +306,7 @@
* fb_json_node_get_arr:
* @root: The root #JsonNode.
* @expr: The #JsonPath expression.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Gets a new #JsonArray value from a parent #JsonNode with a #JsonPath
* expression. The returned #JsonArray should be freed with
@@ -321,7 +321,7 @@
* fb_json_node_get_bool:
* @root: The root #JsonNode.
* @expr: The #JsonPath expression.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Gets a boolean value from a parent #JsonNode with a #JsonPath
* expression.
@@ -335,7 +335,7 @@
* fb_json_node_get_dbl:
* @root: The root #JsonNode.
* @expr: The #JsonPath expression.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Gets a floating point value from a parent #JsonNode with a #JsonPath
* expression.
@@ -349,7 +349,7 @@
* fb_json_node_get_int:
* @root: The root #JsonNode.
* @expr: The #JsonPath expression.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Gets an integer value from a parent #JsonNode with a #JsonPath
* expression.
@@ -363,7 +363,7 @@
* fb_json_node_get_str:
* @root: The root #JsonNode.
* @expr: The #JsonPath expression.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Gets an string value from a parent #JsonNode with a #JsonPath
* expression. The returned string should be freed with #g_free()
@@ -404,8 +404,8 @@
* @values: The #FbJsonValues.
*
* Gets the current working root #JsonNode. This is either the current
- * array #JsonNode, or the root #JsonNode. The returned #JsonNode
- * should not be freed.
+ * array #JsonNode or the root #JsonNode. The returned #JsonNode should
+ * not be freed.
*/
JsonNode *
fb_json_values_get_root(FbJsonValues *values);
@@ -425,7 +425,7 @@
/**
* fb_json_values_update:
* @values: The #FbJsonValues.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Updates the current working root. This should be called after all of
* the #FbJsonValue's have been added with #fb_json_values_add(). If an
--- a/libpurple/protocols/facebook/mqtt.h Tue Dec 15 22:35:05 2015 -0500
+++ b/libpurple/protocols/facebook/mqtt.h Wed Dec 16 14:04:26 2015 -0500
@@ -521,7 +521,7 @@
/**
* fb_mqtt_message_read_byte:
* @msg: The #FbMqttMessage.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads an 8-bit integer value from the #FbMqttMessage. If @value is
* #NULL, this will simply advance the cursor position.
@@ -534,7 +534,7 @@
/**
* fb_mqtt_message_read_mid:
* @msg: The #FbMqttMessage.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads a message identifier from the #FbMqttMessage. If @value is
* #NULL, this will simply advance the cursor position.
@@ -547,7 +547,7 @@
/**
* fb_mqtt_message_read_u16:
* @msg: The #FbMqttMessage.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads a 16-bit integer value from the #FbMqttMessage. If @value is
* #NULL, this will simply advance the cursor position.
@@ -560,7 +560,7 @@
/**
* fb_mqtt_message_read_str:
* @msg: The #FbMqttMessage.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads a string value from the #FbMqttMessage. The value returned to
* @value should be freed with #g_free() when no longer needed. If
--- a/libpurple/protocols/facebook/thrift.h Tue Dec 15 22:35:05 2015 -0500
+++ b/libpurple/protocols/facebook/thrift.h Wed Dec 16 14:04:26 2015 -0500
@@ -193,7 +193,7 @@
/**
* fb_thrift_read_bool:
* @thft: The #FbThrift.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads a boolean value from the #FbThrift. If @value is #NULL, this
* will simply advance the cursor position.
@@ -206,7 +206,7 @@
/**
* fb_thrift_read_byte:
* @thft: The #FbThrift.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads an 8-bit integer value from the #FbThrift. If @value is #NULL,
* this will simply advance the cursor position.
@@ -219,7 +219,7 @@
/**
* fb_thrift_read_dbl:
* @thft: The #FbThrift.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads a 64-bit floating point value from the #FbThrift. If @value
* is #NULL, this will simply advance the cursor position.
@@ -232,7 +232,7 @@
/**
* fb_thrift_read_i16:
* @thft: The #FbThrift.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads a signed 16-bit integer value from the #FbThrift. This will
* convert the integer from the zig-zag format. If @value is #NULL,
@@ -246,7 +246,7 @@
/**
* fb_thrift_read_vi16:
* @thft: The #FbThrift.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads a 16-bit integer value from the #FbThrift. This reads the raw
* integer value without converting it from the zig-zag format. If
@@ -260,7 +260,7 @@
/**
* fb_thrift_read_i32:
* @thft: The #FbThrift.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads a signed 32-bit integer value from the #FbThrift. This will
* convert the integer from the zig-zag format. If @value is #NULL,
@@ -274,7 +274,7 @@
/**
* fb_thrift_read_vi32:
* @thft: The #FbThrift.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads a 32-bit integer value from the #FbThrift. This reads the raw
* integer value without converting it from the zig-zag format. If
@@ -288,7 +288,7 @@
/**
* fb_thrift_read_i64:
* @thft: The #FbThrift.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads a signed 64-bit integer value from the #FbThrift. This will
* convert the integer from the zig-zag format. If @value is #NULL,
@@ -302,7 +302,7 @@
/**
* fb_thrift_read_vi64:
* @thft: The #FbThrift.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads a 64-bit integer value from the #FbThrift. This reads the raw
* integer value without converting it from the zig-zag format. If
@@ -316,7 +316,7 @@
/**
* fb_thrift_read_str:
* @thft: The #FbThrift.
- * @value: The return location for the value, or #NULL.
+ * @value: The return location for the value or #NULL.
*
* Reads a string value from the #FbThrift. The value returned to
* @value should be freed with #g_free() when no longer needed. If
@@ -331,7 +331,7 @@
* fb_thrift_read_field:
* @thft: The #FbThrift.
* @type: The return location for the #FbThriftType.
- * @id: The return location for the identifier, or #NULL.
+ * @id: The return location for the identifier or #NULL.
*
* Reads a field header from the #FbThrift.
*
--- a/libpurple/protocols/facebook/util.h Tue Dec 15 22:35:05 2015 -0500
+++ b/libpurple/protocols/facebook/util.h Wed Dec 16 14:04:26 2015 -0500
@@ -110,7 +110,7 @@
* @acct: The #PurpleAccount.
* @chat: The #PurpleChatConversation.
* @name: The name of the buddy.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Finds a buddy by their name or alias.
*
@@ -244,7 +244,7 @@
* @title: The title of the message or #NULL.
* @primary: The main point of the message or #NULL.
* @secondary: The secondary information or #NULL.
- * @select: A #GSList of selected buddies, or #NULL.
+ * @select: A #GSList of selected buddies or #NULL.
* @multi: #TRUE to for multiple buddy selections, otherwise #FALSE.
* @ok_cb: The callback for the `OK` button or #NULL.
* @cancel_cb: The callback for the `Cancel` button or #NULL.
@@ -320,7 +320,7 @@
/**
* fb_util_zcompress:
* @bytes: The #GByteArray.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Compresses a #GByteArray with zlib. The returned #GByteArray should
* be freed with #g_byte_array_free() when no longer needed.
@@ -333,12 +333,12 @@
/**
* fb_util_zuncompress:
* @bytes: The #GByteArray.
- * @error: The return location for the #GError, or #NULL.
+ * @error: The return location for the #GError or #NULL.
*
* Uncompresses a #GByteArray with zlib. The returned #GByteArray
* should be freed with #g_byte_array_free() when no longer needed.
*
- * Returns: The uncompressed #GByteArray, or #NULL on error.
+ * Returns: The uncompressed #GByteArray or #NULL on error.
*/
GByteArray *
fb_util_zuncompress(const GByteArray *bytes, GError **error);