From efb4b7d294563bb79e9a64739754b78928308802 Mon Sep 17 00:00:00 2001
From: jsing <>
Date: Mon, 27 Aug 2018 15:42:39 +0000
Subject: Fix formatting and grammatical issues with the description of how to
 use i2d_SSL_SESSION. Also rework the example code so that it is clearer and
 uses more appropriate names.

Input from and ok schwarze@, tb@
---
 src/lib/libssl/man/d2i_SSL_SESSION.3 | 36 +++++++++++++++++-------------------
 1 file changed, 17 insertions(+), 19 deletions(-)

(limited to 'src/lib')

diff --git a/src/lib/libssl/man/d2i_SSL_SESSION.3 b/src/lib/libssl/man/d2i_SSL_SESSION.3
index 64f84e6052..9c5c2285fa 100644
--- a/src/lib/libssl/man/d2i_SSL_SESSION.3
+++ b/src/lib/libssl/man/d2i_SSL_SESSION.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: d2i_SSL_SESSION.3,v 1.5 2018/03/27 17:35:50 schwarze Exp $
+.\"	$OpenBSD: d2i_SSL_SESSION.3,v 1.6 2018/08/27 15:42:39 jsing Exp $
 .\"	OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
 .\"
 .\" This file was written by Lutz Jaenicke <jaenicke@openssl.org>.
@@ -48,7 +48,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: March 27 2018 $
+.Dd $Mdocdate: August 27 2018 $
 .Dt D2I_SSL_SESSION 3
 .Os
 .Sh NAME
@@ -131,31 +131,29 @@ the memory location pointed to by
 .Fa pp
 must be large enough to hold the binary representation of the session.
 There is no known limit on the size of the created ASN1 representation,
-so the necessary amount of space should be obtained by first calling
+so call
 .Fn i2d_SSL_SESSION
-with
-.Fa pp Ns
-= Ns
-.Dv NULL ,
-and obtain the size needed, then allocate the memory and call
+first with
+.Fa pp Ns = Ns Dv NULL
+to obtain the encoded size, before allocating the required amount of memory and
+calling
 .Fn i2d_SSL_SESSION
 again.
 Note that this will advance the value contained in
 .Fa *pp
 so it is necessary to save a copy of the original allocation.
 For example:
-.Bd -literal
-int i, j;
+.Bd -literal -offset indent
+char	*p, *pp;
+int	 elen, len;
 
-char *p, *temp;
-
- i = i2d_SSL_SESSION(sess, NULL);
- p = temp = malloc(i);
- if (temp != NULL) {
-	j = i2d_SSL_SESSION(sess, &temp);
-	assert(i == j);
-	assert(p + i == temp);
- }
+elen = i2d_SSL_SESSION(sess, NULL);
+p = pp = malloc(elen);
+if (p != NULL) {
+	len = i2d_SSL_SESSION(sess, &pp);
+	assert(elen == len);
+	assert(p + len == pp);
+}
 .Ed
 .Sh RETURN VALUES
 .Fn d2i_SSL_SESSION
-- 
cgit v1.2.3-55-g6feb