Weed out the last remaining refences to the obsolete

function EVP_MD_CTX_init(3) and talk about EVP_MD_CTX_new(3) instead.
This is similar in spirit to OpenSSL commit 25191fff (Dec 1, 2015),
but  i'm also mentioning EVP_MD_CTX_reset(3), slightly reordering some
sentences in a more systematic way, and improving some related wordings
to be more precise and read better.

1 files changed, 13 insertions, 11 deletions

diff --git a/src/lib/libcrypto/man/EVP_VerifyInit.3 b/src/lib/libcrypto/man/EVP_VerifyInit.3
index dfebe8f2bf..0baadfb9fb 100644
--- a/src/lib/libcrypto/man/EVP_VerifyInit.3
+++ b/src/lib/libcrypto/man/EVP_VerifyInit.3
@@ -1,6 +1,5 @@
-.\" $OpenBSD: EVP_VerifyInit.3,v 1.12 2024/07/21 08:36:43 tb Exp $
-.\" full merge up to: OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
-.\" selective merge up to: OpenSSL 79b49fb0 Mar 20 10:03:10 2018 +1000
+.\" $OpenBSD: EVP_VerifyInit.3,v 1.13 2024/11/08 22:23:35 schwarze Exp $
+.\" full merge up to: OpenSSL 24a535ea Sep 22 13:14:20 2020 +0100
 .\"
 .\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
 .\" Copyright (c) 2000, 2001, 2006, 2016 The OpenSSL Project.
@@ -50,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: July 21 2024 $
+.Dd $Mdocdate: November 8 2024 $
 .Dt EVP_VERIFYINIT 3
 .Os
 .Sh NAME
@@ -86,20 +85,23 @@
 .Fa "const EVP_MD *type"
 .Fc
 .Sh DESCRIPTION
-The EVP signature verification routines are a high level interface to
+The EVP signature verification routines are a high-level interface to
 digital signatures.
 .Pp
 .Fn EVP_VerifyInit_ex
-sets up a verification context
+sets up the verification context
 .Fa ctx
 to use the digest
 .Fa type .
+Before calling this function, obtain
 .Fa ctx
-must be initialized by calling
-.Xr EVP_MD_CTX_init 3
-before calling this function.
+from
+.Xr EVP_MD_CTX_new 3
+or call
+.Xr EVP_MD_CTX_reset 3
+on it.
 The
-.Fa ENGINE *engine
+.Fa engine
 argument is always ignored and passing
 .Dv NULL
 is recommended.
@@ -132,7 +134,7 @@ to use the default implementation of digest
 .Fa type .
 .Pp
 The EVP interface to digital signatures should almost always be
-used in preference to the low level interfaces.
+used in preference to the low-level interfaces.
 This is because the code then becomes transparent to the algorithm used
 and much more flexible.
 .Pp