From: kovan <xaum.io@gmail.com>
Date: Thu, 29 Jan 2026 11:17:38 +0000 (+0100)
Subject: doc: document deprecated engine configure options
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=7ca122e0dead0eea3a3cdecea6eb10a7fd3a233c;p=thirdparty%2Fopenssl.git

doc: document deprecated engine configure options

Document that no-engine, no-static-engine, and no-dynamic-engine
configure options are deprecated and do nothing. These options are
retained for backwards compatibility only.

Fixes #27473

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Reviewed-by: Eugene Syromiatnikov <esyr@openssl.org>
Reviewed-by: Nikola Pajkovsky <nikolap@openssl.org>
Reviewed-by: Milan Broz <mbroz@openssl.org>
MergeDate: Thu Jun 11 09:02:08 2026
(Merged from https://github.com/openssl/openssl/pull/29839)
---

diff --git a/INSTALL.md b/INSTALL.md
index f6d4a132de7..ae31b8207c0 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -868,6 +868,13 @@ Note that if this feature is enabled then GOST ciphersuites are only available
 if the GOST algorithms are also available through loading an externally supplied
 engine.
 
+### no-engine, no-static-engine, no-dynamic-engine
+
+The `no-engine` option is always present.  These options are deprecated and do
+nothing, and are retained for backwards compatibility only.  The ENGINE API was
+deprecated in OpenSSL 3.0 and removed in OpenSSL 4.0, so applications should
+transition to using providers instead.
+
 ### no-http
 
 Disable HTTP support.