Apply suggestions from code review

Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
python · erlend-aasland · Nov 7, 2022 · Jul 28, 2022 · Jul 30, 2022 · Jul 30, 2022
commit 257e46b1f99078508450d512c3ca3e7e7a159ce7
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst
@@ -182,10 +182,11 @@ created.  Socket addresses are represented as follows:
   ``(ifname, proto[, pkttype[, hatype[, addr]]])`` where:
 
   - *ifname* - String specifying the device name.
-  - *proto* - The Ethernet protocol number. May be one of
-    :ref:`ETHERTYPE_* constants <socket-ethernet-types>`
+  - *proto* - The Ethernet protocol number.
+    May be :data:`ETH_P_ALL` to capture all protocols,
+    one of the :ref:`ETHERTYPE_* constants <socket-ethernet-types>`
     or any other Ethernet protocol number.
-    In both cases, values must be in network-byte-order.
+    Value must be in network-byte-order.
   - *pkttype* - Optional integer specifying the packet type:
 
     - ``PACKET_HOST`` (the default) - Packet addressed to the local host.
@@ -509,8 +510,7 @@ Constants
    constructor as *proto* for the :const:`AF_PACKET` family in order to
    capture every packet, regardless of protocol.
 
-   For more information you can consult the Linux documentation
-   :manpage:`packet(7)`.
+   For more information, see the :manpage:`packet(7)` manpage.
 
    .. availability:: Linux.
 

diff --git a/Misc/NEWS.d/next/Core and Builtins/2022-07-30-14-10-27.gh-issue-95389.nSGEkG.rst b/Misc/NEWS.d/next/Core and Builtins/2022-07-30-14-10-27.gh-issue-95389.nSGEkG.rst
@@ -1 +1,3 @@
-Expose some of ``ETHERTYPE_*`` and ``ETH_P_ALL`` constants in :mod:`socket`. Patch by Noam Cohen.
+Expose :data:`~socket.ETH_P_ALL` and some of the
+:ref:`ETHERTYPE_* constants <socket-ethernet-types>` in :mod:`socket`.
+Patch by Noam Cohen.