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)

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>