From: Rémi Denis-Courmont <remi@remlab.net>
Date: Sun, 14 Feb 2010 15:10:05 +0000 (+0200)
Subject: net_Write: improve documentation
X-Git-Tag: 1.1.0-ff~46
X-Git-Url: https://git.sesse.net/?a=commitdiff_plain;h=5a5cbadd836de42cb1655e65e2353edfd9241db1;p=vlc

net_Write: improve documentation
---

diff --git a/src/network/io.c b/src/network/io.c
index 217d971f1f..ab72ebae5d 100644
--- a/src/network/io.c
+++ b/src/network/io.c
@@ -409,7 +409,16 @@ silent:
 }
 
 #undef net_Write
-/* Write exact amount requested */
+/**
+ * Writes data to a file descriptor.
+ * This blocks until all data is written or an error occurs.
+ *
+ * This function is a cancellation point if p_vs is NULL.
+ * This function is not cancellation-safe if p_vs is not NULL.
+ *
+ * @return the total number of bytes written, or -1 if an error occurs
+ * before any data is written.
+ */
 ssize_t net_Write( vlc_object_t *p_this, int fd, const v_socket_t *p_vs,
                    const void *restrict p_data, size_t i_data )
 {