More documentation regarding disabling of roamin profile paraphenalia.

(This used to be commit bb0873dfd09afb4594343699bd0beba122f1390e)

1 files changed, 40 insertions, 31 deletions

diff --git a/docs/smbdotconf/logon/logonpath.xml b/docs/smbdotconf/logon/logonpath.xml
index eb2e9de056..77466c1960 100644
--- a/docs/smbdotconf/logon/logonpath.xml
+++ b/docs/smbdotconf/logon/logonpath.xml
@@ -4,40 +4,42 @@
                  advanced="1" developer="1"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>This parameter specifies the home directory 
-	where roaming profiles (NTuser.dat etc files for Windows NT) are 
-	stored.  Contrary to previous versions of these manual pages, it has 
-	nothing to do with Win 9X roaming profiles.  To find out how to 
-	handle roaming profiles for Win 9X system, see the <smbconfoption name="logon home"/> parameter.</para>
+	<para>
+	This parameter specifies the home directory where roaming profiles (NTuser.dat etc files for Windows NT) are 
+	stored.  Contrary to previous versions of these manual pages, it has nothing to do with Win 9X roaming
+	profiles.  To find out how to handle roaming profiles for Win 9X system, see the
+	<smbconfoption name="logon home"/> parameter.
+	</para>
 
-	<para>This option takes the standard substitutions, allowing you 
-	to have separate logon scripts for each user or machine.  It also 
-	specifies the directory from which the &quot;Application Data&quot;, 
-	(<filename moreinfo="none">desktop</filename>, <filename moreinfo="none">start menu</filename>,
-	<filename moreinfo="none">network neighborhood</filename>, <filename moreinfo="none">programs</filename> 
-	and other folders, and their contents, are loaded and displayed on 
-	your Windows NT client.</para>
+	<para>
+	This option takes the standard substitutions, allowing you to have separate logon scripts for each user or
+	machine.  It also specifies the directory from which the &quot;Application Data&quot;, (<filename
+	moreinfo="none">desktop</filename>, <filename moreinfo="none">start menu</filename>, <filename
+	moreinfo="none">network neighborhood</filename>, <filename moreinfo="none">programs</filename> and other
+	folders, and their contents, are loaded and displayed on your Windows NT client.
+	</para>
 
-	<para>The share and the path must be readable by the user for 
-	the preferences and directories to be loaded onto the Windows NT
-	client. The share must be writeable when the user logs in for the first
-	time, in order that the Windows NT client can create the NTuser.dat
-	and other directories.</para>
+	<para>
+	The share and the path must be readable by the user for the preferences and directories to be loaded onto the
+	Windows NT client. The share must be writeable when the user logs in for the first time, in order that the
+	Windows NT client can create the NTuser.dat and other directories.
+	</para>
 
-	<para>Thereafter, the directories and any of the contents can, 
-	if required, be made read-only.  It is not advisable that the 
-	NTuser.dat file be made read-only - rename it to NTuser.man to 
-	achieve the desired effect (a <emphasis>MAN</emphasis>datory 
-	profile). </para>
+	<para>
+	Thereafter, the directories and any of the contents can, if required, be made read-only.  It is not advisable
+	that the NTuser.dat file be made read-only - rename it to NTuser.man to achieve the desired effect (a
+	<emphasis>MAN</emphasis>datory profile).
+	</para>
 
-	<para>Windows clients can sometimes maintain a connection to 
-	the [homes] share, even though there is no user logged in.  
-	Therefore, it is vital that the logon path does not include a 
-	reference to the homes share (i.e. setting this parameter to
-	\%N\%U\profile_path will cause problems).</para>
+	<para>
+	Windows clients can sometimes maintain a connection to the [homes] share, even though there is no user logged
+	in.  Therefore, it is vital that the logon path does not include a reference to the homes share (i.e. setting
+	this parameter to \%N\%U\profile_path will cause problems).
+	</para>
 
-	<para>This option takes the standard substitutions, allowing 
-	you to have separate logon scripts for each user or machine.</para>
+	<para>
+	This option takes the standard substitutions, allowing you to have separate logon scripts for each user or machine.
+	</para>
 
 	<warning>
         <para>
@@ -52,8 +54,15 @@
 		</para>
 	</warning>
 
-	<para>Note that this option is only useful if Samba is set up 
-	as a logon server.</para>
+	<para>Note that this option is only useful if Samba is set up as a logon server.</para>
+
+	<para>
+	Disable the use of roaming profiles by setting the value of this parameter to the empty string. For
+	example, <smbconfoption name="logon path">""</smbconfoption>. Take note that even if the default setting
+	in the smb.conf file is the empty string, any value specified in the user account settings in the passdb
+	backend will over-ride the effect of setting this parameter to null. Disabling of all roaming profile use
+	requires that the user account settings must also be blank.
+	</para>
 
 	<para>
 	An example of use is: