various cleanup;

1 files changed, 15 insertions, 15 deletions

diff --git a/lib/libcrypto/man/BIO_read.3 b/lib/libcrypto/man/BIO_read.3
index 94a4fb14615..f19c31ecab6 100644
--- a/lib/libcrypto/man/BIO_read.3
+++ b/lib/libcrypto/man/BIO_read.3
@@ -1,12 +1,12 @@
-.\"	$OpenBSD: BIO_read.3,v 1.2 2016/11/06 15:52:50 jmc Exp $
+.\"	$OpenBSD: BIO_read.3,v 1.3 2016/11/07 15:52:47 jmc Exp $
 .\"
-.Dd $Mdocdate: November 6 2016 $
+.Dd $Mdocdate: November 7 2016 $
 .Dt BIO_READ 3
 .Os
 .Sh NAME
 .Nm BIO_read ,
-.Nm BIO_write ,
 .Nm BIO_gets ,
+.Nm BIO_write ,
 .Nm BIO_puts
 .Nd BIO I/O functions
 .Sh SYNOPSIS
@@ -69,17 +69,6 @@ attempts to write a null terminated string
 .Fa buf
 to BIO
 .Fa b .
-.Sh RETURN VALUES
-All these functions return either the amount of data successfully
-read or written (if the return value is positive) or that no data
-was successfully read or written if the result is 0 or -1.
-If the return value is -2, then the operation is not implemented
-in the specific BIO type.
-.Sh NOTES
-A 0 or -1 return is not necessarily an indication of an error.
-In particular when the source/sink is non-blocking or of a certain type
-it may merely be an indication that no data is currently available and that
-the application should retry the operation later.
 .Pp
 One technique sometimes used with blocking sockets
 is to use a system call (such as
@@ -100,7 +89,7 @@ can cause several reads (and writes in the case of SSL BIOs)
 on the underlying I/O structure and may block as a result.
 Instead
 .Xr select 2
-(or equivalent) should be combined with non blocking I/O
+(or equivalent) should be combined with non-blocking I/O
 so successive reads will request a retry instead of blocking.
 .Pp
 See
@@ -113,5 +102,16 @@ function is not supported by a BIO then it is possible to
 work around this by adding a buffering BIO
 .Xr BIO_f_buffer 3
 to the chain.
+.Sh RETURN VALUES
+All these functions return either the amount of data successfully
+read or written (if the return value is positive) or that no data
+was successfully read or written if the result is 0 or -1.
+If the return value is -2, then the operation is not implemented
+in the specific BIO type.
+.Pp
+A 0 or -1 return is not necessarily an indication of an error.
+In particular when the source/sink is non-blocking or of a certain type
+it may merely be an indication that no data is currently available and that
+the application should retry the operation later.
 .Sh SEE ALSO
 .Xr BIO_should_retry 3