From f60657c3221e6890c781533617e16f2dea465b66 Mon Sep 17 00:00:00 2001
From: Petr Viktorin <pviktori@redhat.com>
Date: Jul 20 2021 10:48:30 +0000
Subject: Fix the opt-out mechanism for Machine-readable provides


---

diff --git a/guidelines/modules/ROOT/pages/Python.adoc b/guidelines/modules/ROOT/pages/Python.adoc
index 248689e..5cdd9f5 100644
--- a/guidelines/modules/ROOT/pages/Python.adoc
+++ b/guidelines/modules/ROOT/pages/Python.adoc
@@ -573,6 +573,7 @@ For these cases, the following invocation will provide `+python3-FOO+`,
 Using the generator or macro is important, because the specific form of
 the provide may change in the future.
 
+[#Machine-readable-provides]
 === Machine-readable provides[[_automatic_provides_with_a_standardized_name]]
 
 Every Python package *MUST* provide `+python3dist(DISTNAME)+`
@@ -589,8 +590,9 @@ if the generator fails to add it, the metadata *MUST* be fixed.
 
 These _Provides_ are used for automatically generated _Requires_.
 
-If absolutely necessary, the automatic generator can be disabled by using the
-<<python_disable_dependency_generator,`+%{?python_disable_dependency_generator}+` macro>>.
+If absolutely necessary,
+the automatic generator can be disabled by undefining the
+<<__pythondist_provides,`+%{?__pythondist_provides}+` macro>>.
 Consider discussing your use case with the Python SIG if you need to do this.
 
 === Dependencies
@@ -1721,6 +1723,13 @@ Disables automatic generation of unversioned/versioned provides for package name
 e.g. `+python-FOO+` and `+python3.9-FOO+` for `+python3-foo+`.
 See <<Automatic-unversioned-provides>> for more details.
 
+[#__pythondist_provides]
+* `+%undefine __pythondist_provides+`
++
+Disables automatic generation of machine-readable Provides,
+e.g. `+python3dist(foo)+`.
+See <<Machine-readable-provides>> for more details.
+
 [#_python_no_extras_requires]
 * `+%global _python_no_extras_requires 1+`
 +