From 77c5e333db40bf0eebac2de01b1b8f860f34e916 Mon Sep 17 00:00:00 2001
From: leitner <leitner>
Date: Sat, 27 Nov 2004 01:12:04 +0000
Subject: [PATCH] signal EOF properly

---
 buffer/buffer_get_new_token_sa.3 | 4 ++--
 buffer/buffer_get_token_sa.3     | 4 ++--
 buffer/buffer_get_token_sa.c     | 2 +-
 buffer/buffer_getline_sa.3       | 4 ++--
 buffer/buffer_getnewline_sa.3    | 4 +---
 5 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/buffer/buffer_get_new_token_sa.3 b/buffer/buffer_get_new_token_sa.3
index de3e4c9..251a5f1 100644
--- a/buffer/buffer_get_new_token_sa.3
+++ b/buffer/buffer_get_new_token_sa.3
@@ -18,9 +18,9 @@ If reading from the buffer or allocating memory fails,
 buffer_get_new_token_sa returns -1 and sets \fIerrno\fR appropriately.  At
 that point \fIsa\fR may already contain a partial token.
 
-On success, buffer_get_new_token_sa returns 0.
-
 If you want to read from a non-blocking socket, use buffer_get_token_sa
 instead.
+.SH "RETURN VALUE"
+-1 on error (setting errno), 0 on EOF, 1 when successful.
 .SH "SEE ALSO"
 buffer_getline_sa(3), buffer_get_token(3), buffer(3)
diff --git a/buffer/buffer_get_token_sa.3 b/buffer/buffer_get_token_sa.3
index 32666a0..dc52e4d 100644
--- a/buffer/buffer_get_token_sa.3
+++ b/buffer/buffer_get_token_sa.3
@@ -17,8 +17,8 @@ previous content of \fIsa\fR.  That delimiter is also appended to
 If reading from the buffer or allocating memory fails,
 buffer_get_token_sa returns -1 and sets \fIerrno\fR appropriately.  At
 that point \fIsa\fR may already contain a partial token.
-
-On success, buffer_get_token_sa returns 0.
+.SH "RETURN VALUE"
+-1 on error (setting errno), 0 on EOF, 1 when successful.
 .SH RATIONALE
 buffer_get_token_sa appends instead of overwriting so it can be used on
 non-blocking sockets (these signal error and set \fIerrno\fR to EAGAIN;
diff --git a/buffer/buffer_get_token_sa.c b/buffer/buffer_get_token_sa.c
index 19ce938..7150ed4 100644
--- a/buffer/buffer_get_token_sa.c
+++ b/buffer/buffer_get_token_sa.c
@@ -16,7 +16,7 @@ int buffer_get_token_sa(buffer* b,stralloc* sa,
     stralloc_append(sa,&x);
     if (byte_chr(charset,setlen,x)<setlen) break;
   }
-  return 0;
+  return 1;
 nomem:
   errno=ENOMEM;
   return -1;
diff --git a/buffer/buffer_getline_sa.3 b/buffer/buffer_getline_sa.3
index 6797f2d..fd7a5ce 100644
--- a/buffer/buffer_getline_sa.3
+++ b/buffer/buffer_getline_sa.3
@@ -16,8 +16,8 @@ If reading from the buffer or allocating memory fails,
 buffer_getline_sa returns -1 and sets \fIerrno\fR appropriately.  At
 that point \fIsa\fR may be empty or it may already contain a partial
 token.
-
-On success, buffer_getline_sa returns 0.
+.SH "RETURN VALUE"
+-1 on error (setting errno), 0 on EOF, 1 when successful.
 .SH RATIONALE
 buffer_getline_sa appends instead of overwriting so it can be used on
 non-blocking sockets (these signal error and set \fIerrno\fR to EAGAIN;
diff --git a/buffer/buffer_getnewline_sa.3 b/buffer/buffer_getnewline_sa.3
index 5ee5f44..dab9786 100644
--- a/buffer/buffer_getnewline_sa.3
+++ b/buffer/buffer_getnewline_sa.3
@@ -17,10 +17,8 @@ buffer_getnewline_sa returns -1 and sets \fIerrno\fR appropriately.  At
 that point \fIsa\fR may be empty or it may already contain a partial
 token.
 
-On success, buffer_getnewline_sa returns 0.
-
 To read from a non-blocking socket, use buffer_getline_sa.
 .SH "RETURN VALUE"
-0 on success, -1 on error (setting \fIerrno\fR)
+-1 on error (setting errno), 0 on EOF, 1 when successful.
 .SH "SEE ALSO"
 buffer_get_token_sa(3), buffer(3)