* anything on its own; use g_source_add_child_source() to add other
* sources to it to cause it to trigger.
*
- * Return value: (transfer full): the new #GSource.
+ * Returns: (transfer full): the new #GSource.
*
* Since: 2.28
*/
* g_pollable_source_new(), but also attaching @child_source (with a
* dummy callback), and @cancellable, if they are non-%NULL.
*
- * Return value: (transfer full): the new #GSource.
+ * Returns: (transfer full): the new #GSource.
*
* Since: 2.34
*/
/**
* g_pollable_stream_read:
* @stream: a #GInputStream
- * @buffer: a buffer to read data into
+ * @buffer: (array length=count) (element-type guint8): a buffer to
+ * read data into
* @count: the number of bytes to read
* @blocking: whether to do blocking I/O
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* behavior is undefined. If @blocking is %TRUE, then @stream does not
* need to be a #GPollableOutputStream.
*
- * Return value: %TRUE on success, %FALSE if there was an error
+ * Returns: %TRUE on success, %FALSE if there was an error
*
* Since: 2.34
*/