Commit e322bacb authored by Vladimir Oltean's avatar Vladimir Oltean Committed by David S. Miller
Browse files

Documentation: networking: dsa: demote subsections to simple emphasized words 

"make htmldocs" complains:
configuration.rst:165: WARNING: duplicate label networking/dsa/configuration:single port, other instance in (...)
configuration.rst:212: WARNING: duplicate label networking/dsa/configuration:bridge, other instance in (...)
configuration.rst:252: WARNING: duplicate label networking/dsa/configuration:gateway, other instance in (...)

And for good reason, because the "single port", "bridge" and "gateway"
use cases are replicated twice, once for normal taggers and twice for
DSA_TAG_PROTO_NONE. So when trying to reference these sections via a
hyperlink such as:

https://www.kernel.org/doc/html/latest/networking/dsa/configuration.html#single-port



it will always reference the first occurrence, and never the second one.

This change makes the "single port", "bridge" and "gateway"
configuration examples consistent with the formatting used in the
"Configuration showcases" subsection.

Signed-off-by: default avatarVladimir Oltean <vladimir.oltean@nxp.com>
Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parent 8794be45

Documentation/networking/dsa/configuration.rst

+142 −153
Original line number Diff line number Diff line
@@ -78,9 +78,7 @@ The tagging based configuration is desired and supported by the majority of 
DSA switches. These switches are capable to tag incoming and outgoing traffic

without using a VLAN based configuration.



single port

~~~~~~~~~~~



*single port*

  .. code-block:: sh



    # configure each interface
@@ -96,9 +94,7 @@ single port 
    ip link set lan2 up

    ip link set lan3 up



bridge

~~~~~~



*bridge*

  .. code-block:: sh



    # The master interface needs to be brought up before the slave ports.
@@ -123,9 +119,7 @@ bridge 
    # bring up the bridge

    ip link set dev br0 up



gateway

~~~~~~~



*gateway*

  .. code-block:: sh



    # The master interface needs to be brought up before the slave ports.
@@ -161,8 +155,7 @@ A minority of switches are not capable to use a taging protocol 
(DSA_TAG_PROTO_NONE). These switches can be configured by a VLAN based

configuration.



single port

~~~~~~~~~~~

*single port*

  The configuration can only be set up via VLAN tagging and bridge setup.



  .. code-block:: sh
@@ -208,9 +201,7 @@ The configuration can only be set up via VLAN tagging and bridge setup. 
    ip link set br0 up





bridge

~~~~~~



*bridge*

  .. code-block:: sh



    # tag traffic on CPU port
@@ -248,9 +239,7 @@ bridge 
    # bring up the bridge

    ip link set dev br0 up



gateway

~~~~~~~



*gateway*

  .. code-block:: sh



    # tag traffic on CPU port