mdns-repeater: split into 'Configuration' and 'Example' section

1 files changed, 18 insertions, 8 deletions

diff --git a/docs/services/mdns-repeater.rst b/docs/services/mdns-repeater.rst
index 4664ee84..b247b552 100644
--- a/docs/services/mdns-repeater.rst
+++ b/docs/services/mdns-repeater.rst
@@ -13,21 +13,31 @@ Since the mDNS protocol sends the AA records in the packet itself, the repeater
 does not need to forge the source address. Instead, the source address is of
 the interface that repeats the packet.
 
-.. cfgcmd:: set service mdns repeater interface <interface>
+Configuration
+=============
 
-To enable mDNS repeater you need to configure at least two interfaces. To re-
-broadcast all mDNS packets from `eth0` to `eth1` and vice versa run:
+.. cfgcmd:: set service mdns repeater interface <interface>
 
-.. code-block:: none
-
-  set service mdns repeater interface 'eth0'
-  set service mdns repeater interface 'eth1'
+   To enable mDNS repeater you need to configure at least two interfaces. To
+   re-broadcast all incoming mDNS packets from any interface configured here to
+   any other interface configured under this section.
 
 .. cfgcmd:: set service mdns repeater disable
 
-mDNS repeater can be temporarily disabled without deleting the service using
+   mDNS repeater can be temporarily disabled without deleting the service using
 
 .. note:: You can not run this in a VRRP setup, if multiple mDNS repeaters
    are launched in a subnet you will experience the mDNS packet storm death!
 
+Example
+=======
+
+To listen on both `eth0` and `eth1` mDNS packets and also repeat packets
+received on `eth0` to `eth1` (and vice-versa) use the following commands:
+
+.. code-block:: none
+
+  set service mdns repeater interface 'eth0'
+  set service mdns repeater interface 'eth1'
+
 .. _`Multicast DNS`: https://en.wikipedia.org/wiki/Multicast_DNS