From: tb <tb@openbsd.org>
Date: Sun, 19 Nov 2023 10:25:28 +0000 (+0000)
Subject: Remove section explaining how great and flexible ENGINE is and
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=0703c4d1ba1ce1820d572bb1ccabb1a4bb260975;p=openbsd

Remove section explaining how great and flexible ENGINE is and
remove two Xr to ENGINE manuals.
---

diff --git a/lib/libcrypto/man/evp.3 b/lib/libcrypto/man/evp.3
index b29f76480fe..9ae3012667d 100644
--- a/lib/libcrypto/man/evp.3
+++ b/lib/libcrypto/man/evp.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: evp.3,v 1.24 2023/09/09 14:39:09 schwarze Exp $
+.\" $OpenBSD: evp.3,v 1.25 2023/11/19 10:25:28 tb Exp $
 .\" full merge up to: OpenSSL man7/evp 24a535ea Sep 22 13:14:20 2020 +0100
 .\"
 .\" This file was written by Ulf Moeller <ulf@openssl.org>,
@@ -51,7 +51,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: September 9 2023 $
+.Dd $Mdocdate: November 19 2023 $
 .Dt EVP 3
 .Os
 .Sh NAME
@@ -156,30 +156,6 @@ example, PBKDF2 from PCKS#5).
 The
 .Xr EVP_EncodeInit 3
 family of functions provides base64 encoding and decoding.
-.Pp
-All the symmetric algorithms (ciphers), digests and asymmetric
-algorithms (public key algorithms) can be replaced by
-.Vt ENGINE
-modules providing alternative implementations; see
-.Xr ENGINE_register_RSA 3
-and the related manual pages for more information.
-If
-.Vt ENGINE
-implementations of ciphers or digests are registered as defaults,
-then the various EVP functions will automatically use those
-implementations in preference to built in software implementations.
-.Pp
-Although low-level algorithm specific functions exist for many
-algorithms, their use is discouraged.
-They cannot be used with an
-.Vt ENGINE ,
-and
-.Vt ENGINE
-versions of new algorithms cannot be accessed using the low-level
-functions.
-Using them also makes code harder to adapt to new algorithms, some
-options are not cleanly supported at the low level, and some
-operations are more efficient using the high-level interfaces.
 .Sh SEE ALSO
 .Xr ASN1_item_digest 3 ,
 .Xr ASN1_item_sign 3 ,
@@ -191,8 +167,6 @@ operations are more efficient using the high-level interfaces.
 .Xr crypto 3 ,
 .Xr d2i_PKCS8PrivateKey_bio 3 ,
 .Xr d2i_PrivateKey 3 ,
-.Xr ENGINE_get_cipher 3 ,
-.Xr ENGINE_register_RSA 3 ,
 .Xr EVP_add_cipher 3 ,
 .Xr EVP_AEAD_CTX_init 3 ,
 .Xr EVP_aes_128_cbc 3 ,