s3-docs: Add more verbose description of "log writeable files on exit".

1 files changed, 11 insertions, 4 deletions

diff --git a/docs-xml/smbdotconf/misc/logwriteablefilesonexit.xml b/docs-xml/smbdotconf/misc/logwriteablefilesonexit.xml
index 1c75457803..9d2b750943 100644
--- a/docs-xml/smbdotconf/misc/logwriteablefilesonexit.xml
+++ b/docs-xml/smbdotconf/misc/logwriteablefilesonexit.xml
@@ -5,10 +5,17 @@
 		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
 	<para>
-	This boolean option controls whether at exit time the server
-	dumps a list of files with debug level 0 that were still open
-	for write. This is an administrative aid to find the files
-	that were potentially corrupt if the network connection died.
+	When the network connection between a CIFS client and Samba
+	dies, Samba has no option but to simply shut down the server
+	side of the network connection. If this happens, there is a
+	risk of data corruption because the Windows client did not
+	complete all write operations that the Windows application
+	requested. Setting this option to "yes" makes smbd log with
+	a level 0 message a list of all files that have been opened
+	for writing when the network connection died. Those are the
+	files that are potentially corrupted. It is meant as an aid
+	for the administrator to give him a list of files to do
+	consistency checks on.
 	</para>
 </description>