@@ -133,6 +133,18 @@ only, and indicates that the field value was calculated at wheel build time,
133
133
and may not be the same as the value in the sdist or in other wheels for the
134
134
project.
135
135
136
+ Note in particular that if you have a wheel, you cannot assume that a field
137
+ which is not marked as ``Dynamic `` will have the same value in other wheels, as
138
+ some wheels are not built directly from the sdist, but are modified from
139
+ existing wheels (the ``cibuildwheel `` tool does this, for example). Such
140
+ modifications *could * include changing metadata (even non-dynamic metadata).
141
+ Similarly, if you have a sdist and a wheel which you didn't build from that
142
+ sdist, you cannnot assume that the wheel's metadata matches that of the sdist,
143
+ even if the field is not marked as ``Dynamic ``.
144
+
145
+ It is advisable, but not required, that tools which modify wheel metadata add
146
+ the modified fields to the generated wheel's ``Dynamic `` field.
147
+
136
148
Full details of the semantics of ``Dynamic `` are described in :pep: `643 `.
137
149
138
150
.. _core-metadata-platform :
@@ -923,6 +935,10 @@ Example::
923
935
History
924
936
=======
925
937
938
+ - August 2025: Clarified that ``Dynamic `` only affects how fields
939
+ must be treated when building a wheel from a sdist, not when modifying
940
+ a wheel.
941
+
926
942
- August 2024: Core metadata 2.4 was approved through :pep: `639 `.
927
943
928
944
- Added the ``License-Expression `` field.
0 commit comments