Skip to content

Commit abd4665

Browse files
committed
Use Raymonds wording for the doc
1 parent eeb1cd7 commit abd4665

1 file changed

Lines changed: 11 additions & 5 deletions

File tree

Doc/library/types.rst

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -390,12 +390,18 @@ Standard names are defined for the following types:
390390
signifying (respectively) the types of the underlying mapping's keys and
391391
values.
392392

393-
.. warning::
393+
.. note::
394394

395-
``MappingProxyType`` can expose its internal mapping
396-
in some rare cases on some versions of Python.
397-
Starting from Python 3.15 it is recommeneded
398-
to use truly immutable :class:`frozendict` instead.
395+
There are important differences between ``MappingProxyType``
396+
and :class:`frozendict`.
397+
398+
``MappingProxyType`` is a wrapper around a mapping that renders
399+
the mapping immutable to the viewer of the proxy
400+
without affecting the underlying container.
401+
``MappingProxyType`` can expose its internal mapping in some rare cases.
402+
403+
While ``frozendict`` is a concrete container type
404+
that actually holds data that cannot be changed in any way.
399405

400406
.. versionadded:: 3.3
401407

0 commit comments

Comments
 (0)