docs: Add hint that "socket address" usually don't need to be set.

This fixes bug #5950.
Thanks to the Debian Samba package maintainers for reporting!

Karolin
(cherry picked from commit 19beef0dd9354296ae79d32077c58fbacf570c85)
(cherry picked from commit 0d035d36bd3707ccb9f77f0b2730869dc78719d4)
(cherry picked from commit 6be19f94802d545cc43286aa242b0ca2e5b79721)
(cherry picked from commit 879a4fbe99739b67d877caac2d7a2f763c69d41f)

diff --git a/docs-xml/smbdotconf/misc/socketaddress.xml b/docs-xml/smbdotconf/misc/socketaddress.xml
index 7566380e7092011683f73bba9675f293a938063e..17018efd40a682e344cc3f21cd88db27addf379a 100644 (file)
--- a/docs-xml/smbdotconf/misc/socketaddress.xml
+++ b/docs-xml/smbdotconf/misc/socketaddress.xml
@@ -4,12 +4,14 @@
                 developer="1"
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-       <para>This option allows you to control what 
-       address Samba will listen for connections on. This is used to 
-       support multiple virtual interfaces on the one server, each 
+       <para>This option allows you to control what
+       address Samba will listen for connections on. This is used to
+       support multiple virtual interfaces on the one server, each
        with a different configuration.</para>
-               
-       <para>By default Samba will accept connections on any 
+       <para>Setting this option should never be necessary on usual Samba
+       servers running only one nmbd.</para>
+
+       <para>By default Samba will accept connections on any
                address.</para>
 </description>