deprecate unicode input for RFC822Name (#3836)
* deprecate unicode input for RFC822Name
* pep8...?
diff --git a/docs/x509/reference.rst b/docs/x509/reference.rst
index 5b0bcd4..8b97611 100644
--- a/docs/x509/reference.rst
+++ b/docs/x509/reference.rst
@@ -1232,8 +1232,24 @@
This corresponds to an email address. For example, ``user@example.com``.
+ ..note::
+
+ Starting with version 2.1 unicode input is deprecated. If passing an
+ internationalized domain name (IDN) you should first IDNA encode the
+ hostname and then pass the resulting bytes.
+
+ .. attribute:: bytes_value
+
+ .. versionadded:: 2.1
+
+ :type: bytes
+
.. attribute:: value
+ .. deprecated:: 2.1
+
+ Deprecated accessor for the idna-decoded value of :attr:`bytes_value`
+
:type: :term:`text`
.. class:: DNSName(value)