From c4281e6de630f3caa06c1e7746499ac50abd0f72 Mon Sep 17 00:00:00 2001
From: John Terpstra <jht@samba.org>
Date: Thu, 1 Dec 2005 17:03:58 +0000
Subject: [PATCH] Fixing messy man page information.

---
 docs/smbdotconf/base/interfaces.xml        | 20 +++++++++++-------
 docs/smbdotconf/filename/casesensitive.xml |  2 ++
 docs/smbdotconf/ldap/ldapmachinesuffix.xml | 33 ++++++++++++++++--------------
 docs/smbdotconf/ldap/ldappasswdsync.xml    | 15 +++++++++-----
 4 files changed, 43 insertions(+), 27 deletions(-)
 rewrite docs/smbdotconf/ldap/ldapmachinesuffix.xml (78%)

diff --git a/docs/smbdotconf/base/interfaces.xml b/docs/smbdotconf/base/interfaces.xml
index 1a3af3bb234..2b13200ea6b 100644
--- a/docs/smbdotconf/base/interfaces.xml
+++ b/docs/smbdotconf/base/interfaces.xml
@@ -35,15 +35,21 @@
 	decimal IP address or a hostname which will be looked up via 
 	the OS's normal hostname resolution mechanisms.</para>
 
+	<para>
+	By default Samba enables all active interfaces that are broadcast capable
+	except the loopback adaptor (IP address 127.0.0.1).
+	</para>
+	
+	<para>
+	The example below configures three network interfaces corresponding 
+	to the eth0 device and IP addresses 192.168.2.10 and 192.168.3.10. 
+	The netmasks of the latter two interfaces would be set to 255.255.255.0.
+	</para>
+
 </description>
 <related>bind interfaces only</related>
 
-<value type="example">
-	<comment>This would configure three network interfaces corresponding 
-	to the eth0 device and IP addresses 192.168.2.10 and 192.168.3.10. 
-	The netmasks of the latter two interfaces would be set to 255.255.255.0.</comment>
-	eth0 192.168.2.10/24 192.168.3.10/255.255.255.0
-</value>
+<value type="example">eth0 192.168.2.10/24 192.168.3.10/255.255.255.0</value>
 
-<value type="default"><comment>all active interfaces except 127.0.0.1 that are broadcast capable</comment></value>
+<value type="default"/>
 </samba:parameter>
diff --git a/docs/smbdotconf/filename/casesensitive.xml b/docs/smbdotconf/filename/casesensitive.xml
index 7765adced2d..ed770501cdb 100644
--- a/docs/smbdotconf/filename/casesensitive.xml
+++ b/docs/smbdotconf/filename/casesensitive.xml
@@ -3,8 +3,10 @@
 				 type="boolean"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <synonym>casesignames</synonym>
+
 <description>
 	<para>See the discussion in the section <smbconfoption name="name mangling"/>.</para>
 </description>
+
 <value type="default">no</value>
 </samba:parameter>
diff --git a/docs/smbdotconf/ldap/ldapmachinesuffix.xml b/docs/smbdotconf/ldap/ldapmachinesuffix.xml
dissimilarity index 78%
index 74fab93eca1..b54f6383e8a 100644
--- a/docs/smbdotconf/ldap/ldapmachinesuffix.xml
+++ b/docs/smbdotconf/ldap/ldapmachinesuffix.xml
@@ -1,15 +1,18 @@
-<samba:parameter name="ldap machine suffix"
-                 context="G"
-		 advanced="1" developer="1"
-		 type="string"
-                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
-<description>
-	<para>It specifies where machines should be added to the ldap tree.
-        If this parameter is unset, the value of <smbconfoption
-        name="ldap suffix"/> will be used instead.  The suffix string is pre-pended to the
-        <smbconfoption name="ldap suffix"/> string so use a partial DN.</para>
-</description>
-
-<value type="default"></value>
-<value type="example">ou=Computers</value>
-</samba:parameter>
+<samba:parameter name="ldap machine suffix"
+		context="G"
+		advanced="1"
+		developer="1"
+		type="string"
+		xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+
+<description>
+	<para>
+	It specifies where machines should be added to the ldap tree.  If this parameter is unset, the value of
+	<smbconfoption name="ldap suffix"/> will be used instead.  The suffix string is pre-pended to the
+	<smbconfoption name="ldap suffix"/> string so use a partial DN.
+	</para>
+</description>
+
+<value type="default"/>
+<value type="example">ou=Computers</value>
+</samba:parameter>
diff --git a/docs/smbdotconf/ldap/ldappasswdsync.xml b/docs/smbdotconf/ldap/ldappasswdsync.xml
index 167c206b975..864bfc45a09 100644
--- a/docs/smbdotconf/ldap/ldappasswdsync.xml
+++ b/docs/smbdotconf/ldap/ldappasswdsync.xml
@@ -1,8 +1,10 @@
 <samba:parameter name="ldap passwd sync"
-                 context="G"
-                 advanced="1" developer="1"
-				 type="enum"
-                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+			context="G"
+			advanced="1"
+			developer="1"
+			type="enum"
+			xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+
 <description>
 	<para>
 	This option is used to define whether or not Samba should sync the LDAP password with the NT
@@ -10,7 +12,9 @@
 	change via SAMBA.  
 	</para>
 
-	<para>The <smbconfoption name="ldap passwd sync"/> can be set to one of three values: </para>
+	<para>
+	The <smbconfoption name="ldap passwd sync"/> can be set to one of three values: 
+	</para>
 	
 	<itemizedlist>
 		<listitem>
@@ -29,5 +33,6 @@
 		</listitem>
 	</itemizedlist>		
 </description>
+
 <value type="default">no</value>
 </samba:parameter>
-- 
2.11.4.GIT