Issue #14814: Attempt to clarify network address and broadcast address for less exper...

diff --git a/Doc/library/ipaddress.rst b/Doc/library/ipaddress.rst
index d55511611e541256f01b817a43de4cbb2257c690..fea172463d4d574de45a371d0cd025d63169c09f 100644 (file)
--- a/Doc/library/ipaddress.rst
+++ b/Doc/library/ipaddress.rst
@@ -390,11 +390,13 @@ so to avoid duplication they are only documented for :class:`IPv4Network`.
 
    .. attribute:: network_address
 
-      The broadcast address for the network.
+      The network address for the network. The network address and the
+      prefix length together uniquely define a network.
 
    .. attribute:: broadcast_address
 
-      The broadcast address for the network.
+      The broadcast address for the network. Packets sent to the broadcast
+      address should be received by every host on the network.
 
    .. attribute:: host mask