make use of note and caution markers

python · AA-Turner · Jul 19, 2025 · Jul 19, 2025 · Jul 19, 2025 · Jul 19, 2025
commit 5a0b8e14b058cdefc1282c9f07c91e9126f656db
diff --git a/Doc/library/ipaddress.rst b/Doc/library/ipaddress.rst
@@ -243,11 +243,13 @@ write code that handles both IP versions correctly.  Address objects are
       ``True`` if the address is noted as reserved by the IETF.
       For IPv4, this is only ``240.0.0.0/4``, the ``Reserved`` address block.
       For IPv6, this is all addresses `allocated <iana-ipv6-address-space_>`__ as
-      ``Reserved by IETF`` for future use, except ``fec0::/10`` a former Site-Local scoped
-      address prefix (see :attr:`~IPv6Address.is_site_local`).
+      ``Reserved by IETF`` for future use.
 
-      Note: ``is_reserved`` is not related to the IPv4 address block value of the
-      ``Reserved-by-Protocol`` column in iana-ipv4-special-registry_.
+      .. note:: For IPv4, ``is_reserved`` is not related to the address block value of the
+        ``Reserved-by-Protocol`` column in iana-ipv4-special-registry_.
+
+      .. caution:: For IPv6, ``fec0::/10`` a former Site-Local scoped address prefix is
+         currently excluded from that list (see :attr:`~IPv6Address.is_site_local`).
 
    .. attribute:: is_loopback