https://github.com/python/cpython/commit/bb5c6875d6e84bf2b4e134ed482141a51d223f09
commit: bb5c6875d6e84bf2b4e134ed482141a51d223f09
branch: main
author: donBarbos <[email protected]>
committer: zooba <[email protected]>
date: 2025-02-03T16:42:12Z
summary:
gh-111637: Clarify MIME type recognition behavior in mimetypes documentation
(GH-129546)
files:
M Doc/library/mimetypes.rst
diff --git a/Doc/library/mimetypes.rst b/Doc/library/mimetypes.rst
index 8ad4850584a7e1..514e773359a9aa 100644
--- a/Doc/library/mimetypes.rst
+++ b/Doc/library/mimetypes.rst
@@ -47,9 +47,11 @@ the information :func:`init` sets up.
The optional *strict* argument is a flag specifying whether the list of
known MIME types
is limited to only the official types `registered with IANA
<https://www.iana.org/assignments/media-types/media-types.xhtml>`_.
- When *strict* is ``True`` (the default), only the IANA types are supported;
when
- *strict* is ``False``, some additional non-standard but commonly used MIME
types
- are also recognized.
+ However, the behavior of this module also depends on the underlying
operating
+ system. Only file types recognized by the OS or explicitly registered with
+ Python's internal database can be identified. When *strict* is ``True`` (the
+ default), only the IANA types are supported; when *strict* is ``False``,
some
+ additional non-standard but commonly used MIME types are also recognized.
.. versionchanged:: 3.8
Added support for *url* being a :term:`path-like object`.
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: [email protected]
