Make this page much more readable by deleting as much text as possible

about functions that are deprecated, identical to other functions, and
never made sense in the first place.
As deraadt@ points out, we should not hide the information that
matters in a heap of clutter.  It would waste reader's time and
make confusion and accidental misuse more likely.
OK deraadt@ jmc@

1 files changed, 9 insertions, 28 deletions

diff --git a/src/lib/libcrypto/man/BN_rand.3 b/src/lib/libcrypto/man/BN_rand.3
index a0b1ab9f6c..b5966bcfa2 100644
--- a/src/lib/libcrypto/man/BN_rand.3
+++ b/src/lib/libcrypto/man/BN_rand.3
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: BN_rand.3,v 1.13 2018/12/22 00:03:51 schwarze Exp $
+.\"     $OpenBSD: BN_rand.3,v 1.14 2018/12/24 10:07:22 schwarze Exp $
 .\" full merge up to: OpenSSL 05ea606a May 20 20:52:46 2016 -0400
 .\" selective merge up to: OpenSSL df75c2bf Dec 9 01:02:36 2018 +0100
 .\"
@@ -50,13 +50,13 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: December 22 2018 $
+.Dd $Mdocdate: December 24 2018 $
 .Dt BN_RAND 3
 .Os
 .Sh NAME
 .Nm BN_rand ,
-.Nm BN_pseudo_rand ,
 .Nm BN_rand_range ,
+.Nm BN_pseudo_rand ,
 .Nm BN_pseudo_rand_range
 .Nd generate pseudo-random number
 .Sh SYNOPSIS
@@ -69,22 +69,10 @@
 .Fa "int bottom"
 .Fc
 .Ft int
-.Fo BN_pseudo_rand
-.Fa "BIGNUM *rnd"
-.Fa "int bits"
-.Fa "int top"
-.Fa "int bottom"
-.Fc
-.Ft int
 .Fo BN_rand_range
 .Fa "BIGNUM *rnd"
 .Fa "BIGNUM *range"
 .Fc
-.Ft int
-.Fo BN_pseudo_rand_range
-.Fa "BIGNUM *rnd"
-.Fa "BIGNUM *range"
-.Fc
 .Sh DESCRIPTION
 .Fn BN_rand
 generates a cryptographically strong pseudo-random number of
@@ -114,17 +102,18 @@ is +1 then
 .Fa top
 cannot also be 1.
 .Pp
-.Fn BN_pseudo_rand
-is a deprecated alias for
-.Fn BN_rand .
-.Pp
 .Fn BN_rand_range
 generates a cryptographically strong pseudo-random number
 .Fa rnd
 in the range 0 <=
 .Fa rnd No < Fa range .
-.Fn BN_pseudo_rand_range
+.Pp
+.Fn BN_pseudo_rand
 is a deprecated alias for
+.Fn BN_rand ,
+and
+.Fn BN_pseudo_rand_range
+for
 .Fn BN_rand_range .
 .Sh RETURN VALUES
 The functions return 1 on success, 0 on error.
@@ -140,17 +129,9 @@ The error codes can be obtained by
 first appeared in SSLeay 0.5.1 and has been available since
 .Ox 2.4 .
 .Pp
-.Fn BN_pseudo_rand
-first appeared in OpenSSL 0.9.5 and has been available since
-.Ox 2.7 .
-.Pp
 The
 .Fa top
 == -1 case and the function
 .Fn BN_rand_range
 first appeared in OpenSSL 0.9.6a and have been available since
 .Ox 3.0 .
-.Pp
-.Fn BN_pseudo_rand_range
-first appeared in OpenSSL 0.9.6c and have been available since
-.Ox 3.2 .