@@ -84,26 +84,29 @@ Dynamic (multiple use)
8484
8585.. versionadded :: 2.2
8686
87- Only permitted in source distribution (sdist) file metadata.
88-
89- A string containing the name of another core metadata field. Only the following
90- metadata field names may be used as the value of the ``Dynamic `` field.
91-
92- * ``Platform ``
93- * ``Supported-Platform ``
94- * ``Requires-Dist ``
95- * ``Requires-External ``
96- * ``Provides-Extra ``
97- * ``Provides-Dist ``
98- * ``Obsoletes-Dist ``
99-
100- Unless specified via ``Dynamic ``, *all * metadata in a wheel must be identical to
101- the metadata of the sdist from which the wheel was built. If a field is named in
102- ``Dynamic `` in the sdist, then there is no constraint on what value that field
103- may have in wheels built from the sdist.
104-
105- If the sdist metadata version is older than version 2.2, then there are no
106- constraints on the metadata of wheels built from that sdist.
87+ A string containing the name of another core metadata field. The field
88+ names ``Name `` and ``Version `` may not be specified in this field.
89+
90+ When found in the metadata of a source distribution, the following
91+ rules apply:
92+
93+ 1. If a field is *not * marked as ``Dynamic ``, then the value of the field
94+ in any wheel built from the sdist MUST match the value in the sdist.
95+ If the field is not in the sdist, and not marked as ``Dynamic ``, then
96+ it MUST NOT be present in the wheel.
97+ 2. If a field is marked as ``Dynamic ``, it may contain any valid value in
98+ a wheel built from the sdist (including not being present at all).
99+
100+ If the sdist metadata version is older than version 2.2, then all fields should
101+ be treated as if they were specified with ``Dynamic `` (i.e. there are no special
102+ restrictions on the metadata of wheels built from the sdist).
103+
104+ In any context other than a source distribution, ``Dynamic `` is for information
105+ only, and indicates that the field value was calculated at wheel build time,
106+ and may not be the same as the value in the sdist or in other wheels for the
107+ project.
108+
109+ Full details of the semantics of ``Dynamic `` are described in :pep: `643 `.
107110
108111
109112Platform (multiple use)
0 commit comments