From 9ea4133fac2db3e391c29787a1eaab024b9c1b92 Mon Sep 17 00:00:00 2001
From: Herrtian <70463940+Herrtian@users.noreply.github.com>
Date: Fri, 22 May 2026 19:01:57 +0200
Subject: [PATCH] Document optional dependency metadata mapping

---
 doc/pyproject_toml.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/pyproject_toml.rst b/doc/pyproject_toml.rst
index d58850bf..8bef1ab9 100644
--- a/doc/pyproject_toml.rst
+++ b/doc/pyproject_toml.rst
@@ -170,6 +170,10 @@ You can call these optional features anything you want, although ``test`` and
 ``doc`` are common ones. You specify them for installation in square brackets
 after the package name or directory, e.g. ``pip install '.[test]'``.
 
+These optional dependency groups are written to core metadata as
+``Provides-Extra`` and ``Requires-Dist`` entries. In older
+``[tool.flit.metadata]`` projects, this was configured with ``requires-extra``.
+
 .. _pyproject_project_urls:
 
 URLs table