From: donBarbos <donbarbos@proton.me>
Date: Mon, 3 Feb 2025 16:42:12 +0000 (+0400)
Subject: gh-111637: Clarify MIME type recognition behavior in mimetypes documentation (GH... 
X-Git-Tag: v3.14.0a5~119
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=bb5c6875d6e84bf2b4e134ed482141a51d223f09;p=thirdparty%2FPython%2Fcpython.git

gh-111637: Clarify MIME type recognition behavior in mimetypes documentation (GH-129546)
---

diff --git a/Doc/library/mimetypes.rst b/Doc/library/mimetypes.rst
index 8ad4850584a7..514e773359a9 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`.