docs: document drop of support for macOS < 14 arm64 packages

See ticket #858.

diff --git a/docs/basic/install.rst b/docs/basic/install.rst
index 13719d404713adcc796d36f7a13a1ea6103e2c32..749b2022c352cc58134e9a0fcad15065a7e98d40 100644 (file)
--- a/docs/basic/install.rst
+++ b/docs/basic/install.rst
@@ -62,8 +62,22 @@ This will install a self-contained package with all the libraries needed.
 **You will need pip 20.3 at least**: please run ``pip install --upgrade pip``
 to update it beforehand.
 
-The above package should work in most situations. It **will not work** in
-some cases though.
+.. note::
+
+    Binary packages are produced on a best-effort basis; the supported
+    platforms depends on the support of adequate CI runners to build the
+    packages. You can check the `psycopg-binary PyPI files`__ to verify
+    that your platform is supported.
+
+    .. __: https://pypi.org/project/psycopg-binary/#files
+
+.. warning::
+
+    Starting from Psycopg 3.1.20, ARM64 macOS binary packages (i.e. for
+    Apple M1 machines) are no more available for macOS versions before 14.0.
+    Please upgrade your OS to at least 14.0 or use a :ref:`local
+    <local-installation>` or a :ref:`Python <pure-python-installation>`
+    installation.
 
 If your platform is not supported you should proceed to a :ref:`local
 installation <local-installation>` or a :ref:`pure Python installation

diff --git a/docs/news.rst b/docs/news.rst
index d69f6a2aa780a5db2a03421d2d97b90b486dcf91..c793b6c4b6e843a06d4d899507da48a7fd91d960 100644 (file)
--- a/docs/news.rst
+++ b/docs/news.rst
@@ -86,6 +86,9 @@ Psycopg 3.1.20
 - Avoid unneeded escaping checks and memory over-allocation in text copy
   (:ticket:`#829`).
 - Bundle binary package with OpenSSL 3.3.x (:ticket:`#847`).
+- Drop macOS ARM64 binary packages for macOS versions before 14.0 and Python
+  before 3.10 (not for our choice but for the lack of available CI runners;
+  :ticket:`#858`)
 
 
 Psycopg 3.1.19