diff options
Diffstat (limited to 'docs/x509/reference.rst')
| -rw-r--r-- | docs/x509/reference.rst | 44 |
1 files changed, 35 insertions, 9 deletions
diff --git a/docs/x509/reference.rst b/docs/x509/reference.rst index 2e86cb13..71ac9d99 100644 --- a/docs/x509/reference.rst +++ b/docs/x509/reference.rst @@ -1242,13 +1242,18 @@ General Name Classes .. versionadded:: 0.9 - 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. + email address containing an internationalized domain name (IDN) you + should first IDNA encode the hostname and then pass the resulting + bytes. + + This corresponds to an email address. For example, ``user@example.com``. + + :param bytes value: The email address. If the address contains an + internationalized domain name then it must be encoded to an + :term:`A-label` before being passed. .. attribute:: bytes_value @@ -1256,6 +1261,9 @@ General Name Classes :type: bytes + The value as a byte string. This will contain an :term:`A-label` if + the domain in the address is an internationalized domain name. + .. attribute:: value .. deprecated:: 2.1 @@ -1268,14 +1276,26 @@ General Name Classes .. versionadded:: 0.9 + ..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. + This corresponds to a domain name. For example, ``cryptography.io``. + :param bytes value: The domain name. If it is an internationalized domain + name then it must be encoded to an :term:`A-label` before being passed. + .. attribute:: bytes_value .. versionadded:: 2.1 :type: bytes + The value as a byte string. This will contain an :term:`A-label` if + it is an internationalized domain name. + .. attribute:: value .. deprecated:: 2.1 @@ -1298,14 +1318,17 @@ General Name Classes .. versionadded:: 0.9 - This corresponds to a uniform resource identifier. For example, - ``https://cryptography.io``. - ..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. + internationalized domain name (IDN) within the URI you should first + IDNA encode the hostname and then pass the resulting bytes. + + This corresponds to a uniform resource identifier. For example, + ``https://cryptography.io``. + + :param bytes value: The URI. If it contains an internationalized domain + name then it must be encoded to an :term:`A-label` before being passed. .. attribute:: bytes_value @@ -1313,6 +1336,9 @@ General Name Classes :type: bytes + The value as a byte string. This will contain an :term:`A-label` if + the URI contains an internationalized domain name. + .. attribute:: value .. deprecated:: 2.1 |