From: enh <enh@google.com>
Date: Mon, 16 Dec 2024 13:57:14 +0000 (-0500)
Subject: man/man3/getline.3: Clarify ERRORS
X-Git-Tag: man-pages-6.10~50
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ef53ef760638e03ea4b7274fefe8ae600dfa5cda;p=thirdparty%2Fman-pages.git

man/man3/getline.3: Clarify ERRORS

Signed-off-by: Elliott Hughes <enh@google.com>
Message-ID: <CAJgzZoruFUg6X=JUNJXCbBOKs13SX=dsNFNdTMct2VecUFG=ww@mail.gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
---

diff --git a/man/man3/getline.3 b/man/man3/getline.3
index e1c5b0d63..ac1040db2 100644
--- a/man/man3/getline.3
+++ b/man/man3/getline.3
@@ -95,11 +95,13 @@ but not including the terminating null byte (\[aq]\[rs]0\[aq]).
 This value can be used
 to handle embedded null bytes in the line read.
 .P
-Both functions return \-1 on failure to read a line (including end-of-file
-condition).
-In the event of a failure,
+At end of file,
+both functions return \-1 with the file stream end-of-file indicator set.
+On error,
+both functions return \-1 with the file stream error indicator set,
+and with
 .I errno
-is set to indicate the error.
+set to indicate the error.
 .P
 If
 .I *lineptr