summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPhilip Withnall <pwithnall@endlessos.org>2023-04-25 15:17:51 +0100
committerPhilip Withnall <pwithnall@endlessos.org>2023-04-25 15:30:45 +0100
commitdf9d3818ac8b7c55f60da040175c229e7d1def4c (patch)
tree71a5dae9dfc676d40ff01d08d014144e54a4da9b
parent28b1b9d9c3cd1a7cebe9eac53dc49941eb47298c (diff)
downloadglib-df9d3818ac8b7c55f60da040175c229e7d1def4c.tar.gz
glib-unix: Improve documentation for g_unix_fd_source_new()
In particular, document the type of the callback function. Signed-off-by: Philip Withnall <pwithnall@endlessos.org>
-rw-r--r--glib/glib-unix.c9
1 files changed, 6 insertions, 3 deletions
diff --git a/glib/glib-unix.c b/glib/glib-unix.c
index ef0d1fbfb..f671887c9 100644
--- a/glib/glib-unix.c
+++ b/glib/glib-unix.c
@@ -293,12 +293,15 @@ GSourceFuncs g_unix_fd_source_funcs = {
/**
* g_unix_fd_source_new:
* @fd: a file descriptor
- * @condition: IO conditions to watch for on @fd
+ * @condition: I/O conditions to watch for on @fd
*
- * Creates a #GSource to watch for a particular IO condition on a file
+ * Creates a #GSource to watch for a particular I/O condition on a file
* descriptor.
*
- * The source will never close the fd -- you must do it yourself.
+ * The source will never close the @fd — you must do it yourself.
+ *
+ * Any callback attached to the returned #GSource must have type
+ * #GUnixFDSourceFunc.
*
* Returns: the newly created #GSource
*