From d5c6fd881b41b0fc11b65a63d34540d752c6cfdc Mon Sep 17 00:00:00 2001
From: Leo Alt <leo@ethereum.org>
Date: Fri, 9 Dec 2022 10:44:38 +0100
Subject: [PATCH] update docs on the required z3 version
---
CMakeLists.txt | 2 +-
docs/installing-solidity.rst | 2 +-
docs/smtchecker.rst | 3 ++-
3 files changed, 4 insertions(+), 3 deletions(-)
diff --git a/CMakeLists.txt b/CMakeLists.txt
index b43f24494..d04d708ae 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -76,7 +76,7 @@ configure_file("${CMAKE_SOURCE_DIR}/cmake/templates/license.h.in" include/licens
include(EthOptions)
configure_project(TESTS)
set(LATEST_Z3_VERSION "4.11.2")
-set(MINIMUM_Z3_VERSION "4.8.0")
+set(MINIMUM_Z3_VERSION "4.8.16")
find_package(Z3)
if (${Z3_FOUND})
if (${STRICT_Z3_VERSION})
diff --git a/docs/installing-solidity.rst b/docs/installing-solidity.rst
index 9a613d75d..1b6ac6635 100644
--- a/docs/installing-solidity.rst
+++ b/docs/installing-solidity.rst
@@ -326,7 +326,7 @@ The following are dependencies for all builds of Solidity:
+-----------------------------------+-------------------------------------------------------+
| `Git`_ | Command-line tool for retrieving source code. |
+-----------------------------------+-------------------------------------------------------+
-| `z3`_ (version 4.8+, Optional) | For use with SMT checker. |
+| `z3`_ (version 4.8.16+, Optional) | For use with SMT checker. |
+-----------------------------------+-------------------------------------------------------+
| `cvc4`_ (Optional) | For use with SMT checker. |
+-----------------------------------+-------------------------------------------------------+
diff --git a/docs/smtchecker.rst b/docs/smtchecker.rst
index b1a39ee17..c16a3e5d7 100644
--- a/docs/smtchecker.rst
+++ b/docs/smtchecker.rst
@@ -632,7 +632,8 @@ option ``--model-checker-solvers {all,cvc4,eld,smtlib2,z3}`` or the JSON option
.. note::
z3 version 4.8.16 broke ABI compatibility with previous versions and cannot
be used with solc <=0.8.13. If you are using z3 >=4.8.16 please use solc
- >=0.8.14.
+ >=0.8.14, and conversely, only use older z3 with older solc releases.
+ We also recommend using the latest z3 release which is what SMTChecker also does.
Since both BMC and CHC use ``z3``, and ``z3`` is available in a greater variety
of environments, including in the browser, most users will almost never need to be