Elaborate comment.

diff --git a/lib/full-write.c b/lib/full-write.c
index 2a65ac5..aa8cff3 100644 (file)
--- a/lib/full-write.c
+++ b/lib/full-write.c
@@ -34,7 +34,10 @@ extern int errno;
 #endif
 
 /* Write LEN bytes at PTR to descriptor DESC, retrying if interrupted.
-   Return LEN upon success, write's (negative) error code otherwise.  */
+   Return LEN upon success, write's (negative) error code otherwise.
+   As the name implies, this function writes all LEN bytes and returns
+   LEN or it fails and returns the negative value returned by the (final)
+   failing write.  */
 
 int
 full_write (desc, ptr, len)