From aa07e8a8fe2f77d42aea8c29cd01c4cc0b421f3a Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@musicpd.org>
Date: Tue, 30 Oct 2018 21:33:22 +0100
Subject: [PATCH] doc/user.rst: add links to "Listeners"

---
 doc/user.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/doc/user.rst b/doc/user.rst
index ea27a038a..ce8b160a8 100644
--- a/doc/user.rst
+++ b/doc/user.rst
@@ -183,7 +183,8 @@ To enable socket activation, type:
     systemctl enable mpd.socket
     systemctl start mpd.socket
 
-In this configuration, :program:`MPD` will ignore the :dfn:`bind_to_address` and :dfn:`port` settings. 
+In this configuration, :program:`MPD` will ignore the :ref:`listener
+settings <listeners>` (``bind_to_address`` and ``port``).
 
 systemd user unit
 -----------------
@@ -458,6 +459,8 @@ Check the resampler plugin reference for a list of resamplers and how to configu
 Client Connections
 ------------------
 
+.. _listeners:
+
 Listeners
 ~~~~~~~~~
 
@@ -488,6 +491,9 @@ be changed with the port setting::
 
  port "6601"
 
+These settings will be ignored if `systemd socket activation`_ is
+used.
+
 
 Permissions and Passwords
 ~~~~~~~~~~~~~~~~~~~~~~~~~