@@ -447,8 +447,9 @@ An :class:`IMAP4` instance has the following methods:
    method should only be used over a TLS-protected connection, such as
    :class:`IMAP4_SSL` or after :meth:`starttls`.
 
-   It will only work if the server ``CAPABILITY`` response includes
-   the phrase ``AUTH=PLAIN``.
+   It will only work if the server supports the ``PLAIN`` mechanism,
+   which it need not advertise as ``AUTH=PLAIN`` in its ``CAPABILITY``
+   response.
 
    .. versionadded:: next
 
 
@@ -235,6 +235,11 @@ imaplib
   a wrapper for the ``MOVE`` command (:rfc:`6851`).
   (Contributed by Serhiy Storchaka in :gh:`77508`.)
 
+* Add the :meth:`~imaplib.IMAP4.login_plain` method, which authenticates
+  using the ``PLAIN`` SASL mechanism (:rfc:`4616`) and supports non-ASCII
+  user names and passwords.
+  (Contributed by Przemysław Buczkowski and Serhiy Storchaka in :gh:`89869`.)
+
 
 logging
 -------