Update.

(This used to be commit b9723ad0367bae2064a147f42730bc3efd0688ac)

1 files changed, 52 insertions, 37 deletions

diff --git a/docs/Samba3-HOWTO/TOSHARG-msdfs.xml b/docs/Samba3-HOWTO/TOSHARG-msdfs.xml
index b9dbb84865..528f41d8cb 100644
--- a/docs/Samba3-HOWTO/TOSHARG-msdfs.xml
+++ b/docs/Samba3-HOWTO/TOSHARG-msdfs.xml
@@ -23,6 +23,11 @@
 <title>Features and Benefits</title>
 
 	<para>
+<indexterm><primary>distributed file system</primary><see>DFS</see></indexterm>
+<indexterm><primary>physical locations</primary></indexterm>
+<indexterm><primary>higher availability</primary></indexterm>
+<indexterm><primary>load balancing</primary></indexterm>
+<indexterm><primary>logical directories</primary></indexterm>
 	The distributed file system (DFS) provides a means of separating the logical
 	view of files and directories that users see from the actual physical locations
 	of these resources on the network. It allows for higher availability, smoother
@@ -30,24 +35,34 @@
 	</para>
 
 	<para>
-	For information about DFS, refer to the 
-<ulink url="http://www.microsoft.com/NTServer/nts/downloads/winfeatures/NTSDistrFile/AdminGuide.asp">Microsoft documentation</ulink>.
-	This document explains how to host a DFS tree on a UNIX machine (for DFS-aware
-	clients to browse) using Samba.
+<indexterm><primary>DFS</primary></indexterm>
+<indexterm><primary>DFS tree</primary></indexterm>
+<indexterm><primary>DFS-aware</primary></indexterm>
+	For information about DFS, refer to the <ulink
+	url="http://www.microsoft.com/NTServer/nts/downloads/winfeatures/NTSDistrFile/AdminGuide.asp">Microsoft
+	documentation</ulink>.  This document explains how to host a DFS tree on a UNIX machine (for DFS-aware clients
+	to browse) using Samba.
 	</para>
 
 	<para>
-	A Samba server can be made a DFS server by setting the global 
-	Boolean <smbconfoption name="host msdfs"/>
-	parameter in the &smb.conf; file. You designate a share as a DFS
-	root using the share-level Boolean <smbconfoption name="msdfs root"/> parameter. A DFS root directory on Samba hosts DFS
-	links in the form of symbolic links that point to other servers. For example, a symbolic link
-	<filename>junction-&gt;msdfs:storage1\share1</filename> in the share directory acts
-	as the DFS junction. When DFS-aware clients attempt to access the junction link,
-	they are redirected to the storage location (in this case, <parameter>\\storage1\share1</parameter>).
+<indexterm><primary>DFS server</primary></indexterm>
+<indexterm><primary>share-level</primary></indexterm>
+<indexterm><primary>DFS junction</primary></indexterm>
+<indexterm><primary>DFS-aware</primary></indexterm>
+	A Samba server can be made a DFS server by setting the global Boolean <smbconfoption name="host msdfs"/>
+	parameter in the &smb.conf; file. You designate a share as a DFS root using the share-level Boolean
+	<smbconfoption name="msdfs root"/> parameter. A DFS root directory on Samba hosts DFS links in the form of
+	symbolic links that point to other servers. For example, a symbolic link
+	<filename>junction-&gt;msdfs:storage1\share1</filename> in the share directory acts as the DFS junction. When
+	DFS-aware clients attempt to access the junction link, they are redirected to the storage location (in this
+	case, <parameter>\\storage1\share1</parameter>).
 	</para>
 
 	<para>
+<indexterm><primary>DFS-aware</primary></indexterm>
+<indexterm><primary>DFS tree</primary></indexterm>
+<indexterm><primary>DFS links</primary></indexterm>
+<indexterm><primary>DFS</primary></indexterm>
 	DFS trees on Samba work with all DFS-aware clients ranging from Windows 95 to 200x.
 	<link linkend="dfscfg">The following sample configuration</link> shows how to setup a DFS tree on a Samba server.
 	In the <filename>/export/dfsroot</filename> directory, you set up your DFS links to 
@@ -74,18 +89,24 @@
 </smbconfblock>
 </example>
 
-	<para>You should set up the permissions and ownership of 
-	the directory acting as the DFS root so that only designated 
-	users can create, delete, or modify the msdfs links. Also note 
-	that symlink names should be all lowercase. This limitation exists 
-	to have Samba avoid trying all the case combinations to get at 
-	the link name. Finally, set up the symbolic links to point to the 
-	network shares you want and start Samba.</para>
-
-	<para>Users on DFS-aware clients can now browse the DFS tree 
-	on the Samba server at <constant>\\samba\dfs</constant>. Accessing 
-	links linka or linkb (which appear as directories to the client) 
-	takes users directly to the appropriate shares on the network.</para>
+	<para>
+<indexterm><primary>DFS root</primary></indexterm>
+<indexterm><primary>msdfs links</primary></indexterm>
+<indexterm><primary>symbolic links</primary></indexterm>
+	You should set up the permissions and ownership of the directory acting as the DFS root so that only
+	designated users can create, delete, or modify the msdfs links. Also note that symlink names should be all
+	lowercase. This limitation exists to have Samba avoid trying all the case combinations to get at the link
+	name. Finally, set up the symbolic links to point to the network shares you want and start Samba.
+	</para>
+
+	<para>
+<indexterm><primary>DFS-aware clients</primary></indexterm>
+<indexterm><primary>DFS tree</primary></indexterm>
+	Users on DFS-aware clients can now browse the DFS tree on the Samba server at
+	<constant>\\samba\dfs</constant>. Accessing links linka or linkb (which appear as directories to the client)
+	takes users directly to the appropriate shares on the network.
+	</para>
+
 </sect1>
 
 <sect1>
@@ -127,29 +148,23 @@
 
 		<para>
 		<quote>For example, I had a share defined as such:</quote>
-
+		<smbconfblock>
+		<smbconfsection name="[pub]"/>
+		<smbconfoption name="path">/export/home/Shares/public_share</smbconfoption>
+		<smbconfoption name="msdfs root">yes</smbconfoption>
+		</smbconfblock>
+		<quote>and I could not make my Windows 9x/Me (with the dfs client installed) follow this symlink:</quote>
 		<screen>
-		[pub]
-			path = /export/home/Shares/public_share
-			msdfs root = yes
-		</screen>
-
-		<quote>and I could not make my Windows 9x/Me (with the dfs client installed)
-		follow this symlink:</quote>
-
-		<screen>
-			damage1 -> msdfs:damage\test-share
+		damage1 -> msdfs:damage\test-share
 		</screen>
 		</para>
 
 		<para>
 		<quote>Running a debug level of 10 reveals:</quote>
-
 		<programlisting>
 		[2003/08/20 11:40:33, 5] msdfs/msdfs.c:is_msdfs_link(176)
 		  is_msdfs_link: /export/home/shares/public_share/* does not exist.
 		</programlisting>
-
 		<quote>Curious. So I changed the directory name from <constant>.../Shares/...</constant> to
 		<constant>.../shares/...</constant> (along with my service definition) and it worked!</quote>
 		</para>