summaryrefslogtreecommitdiff
path: root/libpurple/queuedoutputstream.h
diff options
context:
space:
mode:
authorElliott Sales de Andrade <quantum.analyst@gmail.com>2022-11-04 00:20:18 -0500
committerElliott Sales de Andrade <quantum.analyst@gmail.com>2022-11-04 00:20:18 -0500
commita55f31aa6ed09f8ca4426cb6caa05d920555332e (patch)
treec077c365197f6a13d1e319d3a2631ced306f85e5 /libpurple/queuedoutputstream.h
parent5b988dbefcf850d3f8faf0992a42be2fda31e776 (diff)
downloadpidgin-a55f31aa6ed09f8ca4426cb6caa05d920555332e.tar.gz
Fix error parameter annotations
The `(optional)` annotation causes a warning because the parameter is not marked as `(out)`. Additionally, the annotations have no effect on the generated documentation. When a function takes `GError **error`, then the GObject introspection data includes `throws="1"`. When gi-docgen sees that annotation, it inserts a standard text about it, so what we write there doesn't matter too much. It will only be seen by people reading the header file directly, so I have inserted a consistent text in those places. Testing Done: Compiled and saw fewer warnings from gobject-introspection. Reviewed at https://reviews.imfreedom.org/r/2019/
Diffstat (limited to 'libpurple/queuedoutputstream.h')
-rw-r--r--libpurple/queuedoutputstream.h3
1 files changed, 1 insertions, 2 deletions
diff --git a/libpurple/queuedoutputstream.h b/libpurple/queuedoutputstream.h
index d578773be0..ee62a1b44b 100644
--- a/libpurple/queuedoutputstream.h
+++ b/libpurple/queuedoutputstream.h
@@ -88,8 +88,7 @@ void purple_queued_output_stream_push_bytes_async(PurpleQueuedOutputStream *stre
* purple_queued_output_stream_push_bytes_finish:
* @stream: The instance.
* @result: The [iface@Gio.AsyncResult] of this operation.
- * @error: (nullable): A [type@Glib.Error] location to store the error, or
- * %NULL to ignore.
+ * @error: Return address for a #GError, or %NULL.
*
* Finishes pushing bytes asynchronously.
*