A slew of fixups that were causing problems for some folk.

(This used to be commit 6b2ea0772cd3ec8cd735acec2cde807d972737c5)

docs/Samba3-HOWTO/index.xml

@@ -216,10 +216,10 @@ The chapters in this part each cover specific Samba features.
 
 <!-- Comment out the following line to include the manpages.
 	 *Please* do not commit with the two lines below enabled! -->
-<!--
+<!-- -->
 	<?latex \cleardoublepage ?>
 	<xi:include href="manpages.xml"/>
--->
+<!-- -->
 	<?latex \cleardoublepage ?>
 
 <xi:include href="http://www.gnu.org/licenses/gpl.xml"/>

docs/smbdotconf/misc/remoteannounce.xml

@@ -33,7 +33,9 @@
 	config is that stable.
 	</para>
 
-<para>See <smbconfoption name="NetworkBrowsing"/>.</para>
+	<para>
+	See the chapter on Network Browsing in the Samba-HOWTO book.
+	</para>
 </description>
 
 <value type="default"></value>

docs/smbdotconf/misc/remotebrowsesync.xml

@@ -6,7 +6,7 @@
 <description>
 	<para>
 	This option allows you to setup <citerefentry><refentrytitle>nmbd</refentrytitle>
-        <manvolnum>8</manvolnum></citerefentry> to periodically request 
+	<manvolnum>8</manvolnum></citerefentry> to periodically request 
 	synchronization of browse lists with the master browser of a Samba 
 	server that is on a remote segment. This option will allow you to 
 	gain browse lists for multiple workgroups across routed networks. This 
@@ -40,7 +40,7 @@
 	</para>
 
 	<para>
-	The <parameter>remote browse sync</parameter> may be used on networks
+	The <smbconfoption name="remote browse sync"/> may be used on networks
 	where there is no WINS server, and may be used on disjoint networks where
 	each network has its own WINS server.
 	</para>

docs/smbdotconf/printing/os2drivermap.xml

@@ -15,9 +15,9 @@
     LaserJet 5L</command>.</para>
 		
     <para>
-    The need for the file is due to the printer driver namespace problem described in <link
+    The need for the file is due to the printer driver namespace problem described in 
-    linkend="classicalprinting">the chapter on Classical Printing in the book Samba3-HOWTO</link>.  For more
+    the chapter on Classical Printing in the Samba3-HOWTO book.  For more
-    details on OS/2 clients, please refer to <link linkend="Other-Clients"/>.
+    details on OS/2 clients, please refer to chapter on other clients in the Samba3-HOWTO book.
     </para>
 </description>
 <value type="default"/>

docs/smbdotconf/protocol/nameresolveorder.xml

@@ -16,23 +16,23 @@
 
     <itemizedlist>
 	<listitem>
-	    <para><constant>lmhosts</constant> : Lookup an IP 
+	    <para>
-	    address in the Samba lmhosts file. If the line in lmhosts has 
+		<constant>lmhosts</constant> : Lookup an IP address in the Samba lmhosts file. If the line in lmhosts has 
-	    no name type attached to the NetBIOS name (see the <usmbconfoption 
+	    no name type attached to the NetBIOS name (see the manpage for lmhosts for details) then
-            noescape="1" url="lmhosts.5.html">lmhosts(5)</usmbconfoption> for details) then
+	    any name type matches for lookup.
-	    any name type matches for lookup.</para>
+		</para>
 	</listitem>
 
 	<listitem>
-	    <para><constant>host</constant> : Do a standard host 
+	    <para>
-	    name to IP address resolution, using the system <filename moreinfo="none">/etc/hosts
+		<constant>host</constant> : Do a standard host name to IP address resolution, using the system
-	    </filename>, NIS, or DNS lookups. This method of name resolution 
+		<filename moreinfo="none">/etc/hosts </filename>, NIS, or DNS lookups. This method of name resolution is
-	    is operating system depended for instance on IRIX or Solaris this 
+		operating system depended for instance on IRIX or Solaris this may be controlled by the <filename
-	    may be controlled by the <filename moreinfo="none">/etc/nsswitch.conf</filename> 
+		moreinfo="none">/etc/nsswitch.conf</filename> file.  Note that this method is used only if the NetBIOS name
-	    file.  Note that this method is used only if the NetBIOS name 
+		type being queried is the 0x20 (server) name type or 0x1c (domain controllers).  The latter case is only
-	    type being queried is the 0x20 (server) name type or 0x1c (domain controllers). 
+		useful for active directory domains and results in a DNS query for the SRV RR entry matching
-            The latter case is only useful for active directory domains and results in a DNS
+		_ldap._tcp.domain.
-            query for the SRV RR entry matching _ldap._tcp.domain.</para>
+	</para>
 	</listitem>
 
 	<listitem>

docs/smbdotconf/security/hostsallow.xml

@@ -5,8 +5,7 @@
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <synonym>allow hosts</synonym>
 <description>
-    <para>A synonym for this parameter is <parameter moreinfo="none">allow 
+    <para>A synonym for this parameter is <smbconfoption name="allow hosts"/>.</para>
-    hosts</parameter>.</para>
 		
     <para>This parameter is a comma, space, or tab delimited 
     set of hosts which are permitted to access a service.</para>
@@ -17,9 +16,9 @@
 
     <para>You can specify the hosts by name or IP number. For 
     example, you could restrict access to only the hosts on a 
-    Class C subnet with something like <command moreinfo="none">allow hosts = 150.203.5.
+    Class C subnet with something like <command>allow hosts = 150.203.5.</command>.
-    </command>. The full syntax of the list is described in the man 
+	The full syntax of the list is described in the man 
-    page <filename moreinfo="none">hosts_access(5)</filename>. Note that this man
+    page <filename>hosts_access(5)</filename>. Note that this man
     page may not be present on your system, so a brief description will
     be given here also.</para>
 

docs/smbdotconf/security/hostsdeny.xml

@@ -14,7 +14,7 @@
 	<para>
 	In the event that it is necessary to deny all by default, use the keyword
 	ALL (or the netmask <literal>0.0.0.0/0</literal>) and then explicitly specify
-	to the <link linkend="hostsallow">hosts allow</link> parameter those hosts
+	to the <smbconfoption name="hosts allow">hosts allow</smbconfoption> parameter those hosts
 	that should be permitted access.
 	</para>
 </description>

docs/smbdotconf/vfs/hostmsdfs.xml

@@ -4,13 +4,14 @@
                  advanced="1" developer="1"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
  <description>
-        <para>If set to <constant>yes</constant>, Samba will act as a Dfs
+	<para>
-	server, and allow Dfs-aware clients to browse Dfs trees hosted
+	If set to <constant>yes</constant>, Samba will act as a Dfs server, and allow Dfs-aware clients to browse
-	on the server.</para>
+	Dfs trees hosted on the server.
+	</para>
 
-	<para>See also the <smbconfoption name="msdfs root"/> share  level  parameter.  For
+	<para>
-	more  information  on  setting  up a Dfs tree on Samba,
+	See also the <smbconfoption name="msdfs root"/> share  level  parameter.  For more  information  on
-	refer to <link linkend="msdfs">the MSFDS chapter in the book Samba3-HOWTO</link>.
+	setting  up a Dfs tree on Samba, refer to the MSFDS chapter in the book Samba3-HOWTO.
 	</para>
 </description>
 

docs/smbdotconf/vfs/msdfsroot.xml

@@ -7,10 +7,9 @@
 	share as a Dfs root and allows clients to browse the
 	distributed file system tree rooted at the share directory.
 	Dfs links are specified in the share directory by symbolic
-	links of the form <filename
+	links of the form <filename>msdfs:serverA\\shareA,serverB\\shareB</filename>
-	moreinfo="none">msdfs:serverA\\shareA,serverB\\shareB</filename>
 	and so on.  For more information on setting up a Dfs tree on
-	Samba, refer to <link linkend="msdfs">the MSDFS chapter in the Samba3-HOWTO book</link>.</para>
+	Samba, refer to the MSDFS chapter in the Samba3-HOWTO book.</para>
 </description>
 
 <related>host msdfs</related>

docs/smbdotconf/winbind/winbindtrusteddomainsonly.xml

@@ -4,13 +4,12 @@
                  advanced="1" developer="1"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>This parameter is designed to allow Samba servers that
+	<para>
-	are members of a Samba controlled domain to use UNIX accounts
+	This parameter is designed to allow Samba servers that are members of a Samba controlled domain to use
-	distributed via NIS, rsync, or LDAP as the uid's for winbindd users
+	UNIX accounts distributed via NIS, rsync, or LDAP as the uid's for winbindd users in the hosts primary domain.
-	in the hosts primary domain.  Therefore, the user DOMAIN\user1 would
+	Therefore, the user <literal>DOMAIN\user1</literal> would be mapped to the account user1 in /etc/passwd
-	be mapped to the account user1 in /etc/passwd instead of allocating
+	instead of allocating a new uid for him or her.
-	a new uid for him or her.
+	</para>
-</para>
 </description>
 
 <value type="default">no</value>

docs/smbdotconf/wins/winsserver.xml

@@ -21,7 +21,7 @@
 	<note><para>You need to set up Samba to point 
 	to a WINS server if you have multiple subnets and wish cross-subnet 
 	browsing to work correctly.</para></note>
-	<para>See the <link linkend="NetworkBrowsing"/>.</para>
+	<para>See the chapter in the Samba3-HOWTO on Network Browsing.</para>
 </description>
 
 <value type="default"></value>