From c8ba07ca4a779114958eb1bb66096f09b783d90d Mon Sep 17 00:00:00 2001
From: Ronald Oussoren <ronaldoussoren@mac.com>
Date: Mon, 4 Apr 2022 21:43:56 +0200
Subject: [PATCH] Document an incompatibility with setuptools 61.0

Issue #414
---
 doc/changelog.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doc/changelog.rst b/doc/changelog.rst
index d3d7177..4212548 100644
--- a/doc/changelog.rst
+++ b/doc/changelog.rst
@@ -4,6 +4,21 @@ Release history
 py2app 0.28
 -----------
 
+.. warning:: incompatibility with setuptools 61.0
+
+   Setuptools 61.0 introduces autodiscovery of distribution
+   attributes, and this might affect users of py2app. Two
+   related error scenario's are:
+
+   - The name of the generated application is not based on
+     the script name, but some other value.
+
+   - Calling ``python setup.py py2app`` results in an error
+     mentioning ``Multiple top-level modules discovered``.
+
+   To disable autodiscovery by setuptools update the setup.py
+   file and add ``py_modules=[]`` to the call to setup().
+
 * #417: Also include package dist-info for editable installs
 
 * The qt5 and qt6 recipes used dodge logic to detect