From 3245fd539b2978123fa1c26c31c3786993be1511 Mon Sep 17 00:00:00 2001
From: schwarze <>
Date: Fri, 6 Jan 2017 03:45:57 +0000
Subject: Delete a cross reference to the non-existent manual page
 BIO_set_flags(3), reported by jmc@.  Documenting that function would be a bad
 idea.  All other flags are used internally and should better not be tampered
 with. It looks like an internal function that was made public by mistake,
 then abused for an unrelated user interface purpose: a classic case of
 botched user interface design.

Instead, only show how to use this function for this one specific purpose.

While here, delete a sentence from the DESCRIPTION that merely
duplicated content from the BUGS section.
---
 src/lib/libcrypto/man/BIO_f_base64.3 | 19 ++++++++-----------
 1 file changed, 8 insertions(+), 11 deletions(-)

(limited to 'src')

diff --git a/src/lib/libcrypto/man/BIO_f_base64.3 b/src/lib/libcrypto/man/BIO_f_base64.3
index c1bc926b22..a3bf74c4fe 100644
--- a/src/lib/libcrypto/man/BIO_f_base64.3
+++ b/src/lib/libcrypto/man/BIO_f_base64.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: BIO_f_base64.3,v 1.6 2016/12/06 14:45:08 schwarze Exp $
+.\"	$OpenBSD: BIO_f_base64.3,v 1.7 2017/01/06 03:45:57 schwarze Exp $
 .\"	OpenSSL fc1d88f0 Wed Jul 2 22:42:40 2014 -0400
 .\"
 .\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
@@ -49,7 +49,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: December 6 2016 $
+.Dd $Mdocdate: January 6 2017 $
 .Dt BIO_F_BASE64 3
 .Os
 .Sh NAME
@@ -78,15 +78,12 @@ on a base64 BIO that is being written through
 is used to signal that no more data is to be encoded:
 this is used to flush the final block through the BIO.
 .Pp
-The flag
-.Dv BIO_FLAGS_BASE64_NO_NL
-can be set with
-.Xr BIO_set_flags 3
-to encode the data all on one line
-or expect the data to be all on one line.
-.Pp
-Because of the format of base64 encoding the end of the encoded
-block cannot always be reliably determined.
+To encode the data all on one line and to expect the data to be all
+on one line, initialize the base64 BIO as follows:
+.Bd -literal -offset indent
+BIO *b64 = BIO_new(BIO_f_base64());
+BIO_set_flags(b64, BIO_FLAGS_BASE64_NO_NL);
+.Ed
 .Sh RETURN VALUES
 .Fn BIO_f_base64
 returns the base64 BIO method.
-- 
cgit v1.2.3-55-g6feb