Formatting and other fixes to man pages.

(This used to be commit 411025ed0d6ba37ff00f4afc8ccdc9dae94b62e0)

18 files changed, 167 insertions, 139 deletions

diff --git a/docs/smbdotconf/misc/afsshare.xml b/docs/smbdotconf/misc/afsshare.xml
index 9dfa69bbcb..67d42d491f 100644
--- a/docs/smbdotconf/misc/afsshare.xml
+++ b/docs/smbdotconf/misc/afsshare.xml
@@ -9,7 +9,7 @@
 	the <parameter>path</parameter> parameter is a local AFS import. The
 	special AFS features include the attempt to hand-craft an AFS token
 	if you enabled --with-fake-kaserver in configure.
-</para>
+	</para>
 </description>
 
 <value type="default">no</value>
diff --git a/docs/smbdotconf/misc/dfreecommand.xml b/docs/smbdotconf/misc/dfreecommand.xml
index 1c058d2918..4a9de5c84d 100644
--- a/docs/smbdotconf/misc/dfreecommand.xml
+++ b/docs/smbdotconf/misc/dfreecommand.xml
@@ -28,21 +28,23 @@
 	<para>Note: Your script should <emphasis>NOT</emphasis> be setuid or 
 	setgid and should be owned by (and writeable only by) root!</para>
 
-	<para>Where the script dfree (which must be made executable) could be:</para>
-
-<para><programlisting format="linespecific"> 
+	<para>Where the script dfree (which must be made executable) could be:
+<programlisting format="linespecific"> 
 #!/bin/sh
 df $1 | tail -1 | awk '{print $2&quot; &quot;$4}'
-</programlisting></para>
-
-	<para>or perhaps (on Sys V based systems):</para>
+</programlisting>
+	</para>
 
-<para><programlisting format="linespecific"> 
+	<para>or perhaps (on Sys V based systems):
+<programlisting format="linespecific"> 
 #!/bin/sh
 /usr/bin/df -k $1 | tail -1 | awk '{print $3&quot; &quot;$5}'
-</programlisting></para>
+</programlisting>
+	</para>
 		
-	<para>Note that you may have to replace the command names with full path names on some systems.</para>
+	<para>
+	Note that you may have to replace the command names with full path names on some systems.
+	</para>
 
 </description>
 <value type="default"><comment>By default internal routines for 
diff --git a/docs/smbdotconf/misc/followsymlinks.xml b/docs/smbdotconf/misc/followsymlinks.xml
index d3113d658a..c0fd920bf9 100644
--- a/docs/smbdotconf/misc/followsymlinks.xml
+++ b/docs/smbdotconf/misc/followsymlinks.xml
@@ -3,19 +3,18 @@
 			 type="boolean"
 		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>This parameter allows the Samba administrator 
-	to stop <citerefentry><refentrytitle>smbd</refentrytitle>
-	<manvolnum>8</manvolnum></citerefentry>	from following symbolic 
-	links in a particular share. Setting this 
-	parameter to <constant>no</constant> prevents any file or directory 
-	that is a symbolic link from being followed (the user will get an 
-	error).  This option is very useful to stop users from adding a 
-	symbolic link to <filename moreinfo="none">/etc/passwd</filename> in their home 
-	directory for instance.  However it will slow filename lookups 
-	down slightly.</para>
+	<para>
+	This parameter allows the Samba administrator to stop <citerefentry><refentrytitle>smbd</refentrytitle>
+	<manvolnum>8</manvolnum></citerefentry>	from following symbolic links in a particular share. Setting this 
+	parameter to <constant>no</constant> prevents any file or directory that is a symbolic link from being 
+	followed (the user will get an 	error).  This option is very useful to stop users from adding a symbolic 
+	link to <filename moreinfo="none">/etc/passwd</filename> in their home directory for instance.  However 
+	it will slow filename lookups down slightly.
+	</para>
 
-	<para>This option is enabled (i.e. <command moreinfo="none">smbd</command> will 
-		follow symbolic links) by default.</para>
+	<para>
+	This option is enabled (i.e. <command moreinfo="none">smbd</command> will follow symbolic links) by default.
+	</para>
 </description>
 <value type="default">yes</value>
 </samba:parameter>
diff --git a/docs/smbdotconf/misc/fstype.xml b/docs/smbdotconf/misc/fstype.xml
index 3c1da17633..c7df18c38b 100644
--- a/docs/smbdotconf/misc/fstype.xml
+++ b/docs/smbdotconf/misc/fstype.xml
@@ -3,14 +3,13 @@
 			 type="string"
 		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>This parameter allows the administrator to 
-	configure the string that specifies the type of filesystem a share 
-	is using that is reported by <citerefentry><refentrytitle>smbd</refentrytitle>
-	<manvolnum>8</manvolnum></citerefentry> when a client queries the filesystem type
-	for a share. The default type is <constant>NTFS</constant> for 
-	compatibility with Windows NT but this can be changed to other 
-	strings such as <constant>Samba</constant> or <constant>FAT
-	</constant> if required.</para>
+	<para>
+	This parameter allows the administrator to configure the string that specifies the type of filesystem a share 
+	is using that is reported by <citerefentry><refentrytitle>smbd</refentrytitle> <manvolnum>8</manvolnum></citerefentry> 
+	when a client queries the filesystem type for a share. The default type is <constant>NTFS</constant> for compatibility 
+	with Windows NT but this can be changed to other strings such as <constant>Samba</constant> or <constant>FAT</constant> 
+	if required.
+	</para>
 </description>
 <value type="default">NTFS</value>
 <value type="example">Samba</value>
diff --git a/docs/smbdotconf/misc/homedirmap.xml b/docs/smbdotconf/misc/homedirmap.xml
index 3459928b58..37b46ee0b6 100644
--- a/docs/smbdotconf/misc/homedirmap.xml
+++ b/docs/smbdotconf/misc/homedirmap.xml
@@ -4,23 +4,21 @@
 		 advanced="1" developer="1"
 		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
  <description>
-	<para>If <smbconfoption name="nis homedir"/> is <constant>yes</constant>,
-	and <citerefentry><refentrytitle>smbd</refentrytitle>
-	<manvolnum>8</manvolnum></citerefentry> is also acting 
-	as a Win95/98 <parameter moreinfo="none">logon server</parameter> then this parameter 
-	specifies the NIS (or YP) map from which the server for the user's 
-	home directory should be extracted.  At present, only the Sun 
-	auto.home map format is understood. The form of the map is:</para>
-
-	<para><command moreinfo="none">username	server:/some/file/system</command></para>
-
-	<para>and the program will extract the servername from before 
-	the first ':'.  There should probably be a better parsing system 
-	that copes with different map formats and also Amd (another 
-	automounter) maps.</para>
+	<para>
+	If <smbconfoption name="nis homedir"/> is <constant>yes</constant>, and <citerefentry><refentrytitle>smbd</refentrytitle>
+	<manvolnum>8</manvolnum></citerefentry> is also acting 	as a Win95/98 <parameter moreinfo="none">logon server</parameter> 
+	then this parameter specifies the NIS (or YP) map from which the server for the user's 	home directory should be extracted.  
+	At present, only the Sun auto.home map format is understood. The form of the map is:
+<programlisting>
+<command moreinfo="none">username server:/some/file/system</command>
+</programlisting>
+	and the program will extract the servername from before the first ':'.  There should probably be a better parsing system 
+	that copes with different map formats and also Amd (another automounter) maps.
+	</para>
 		
-	<note><para>A working NIS client is required on 
-	the system for this option to work.</para></note>
+	<note><para>
+	A working NIS client is required on the system for this option to work.
+	</para></note>
 </description>
 <related>nis homedir</related>
 <related>domain logons</related>
diff --git a/docs/smbdotconf/misc/include.xml b/docs/smbdotconf/misc/include.xml
index 409c9aff3c..17ccea33c0 100644
--- a/docs/smbdotconf/misc/include.xml
+++ b/docs/smbdotconf/misc/include.xml
@@ -4,13 +4,15 @@
 		 hide="1"
 		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>This allows you to include one config file 
-	inside another.  The file is included literally, as though typed 
-	in place.</para>
+	<para>
+	This allows you to include one config file inside another.  The file is included literally, as though typed 
+	in place.
+	</para>
 
-	<para>It takes the standard substitutions, except <parameter moreinfo="none">%u
-	</parameter>, <parameter moreinfo="none">%P</parameter> and <parameter moreinfo="none">%S</parameter>.
-</para>
+	<para>
+	It takes the standard substitutions, except <parameter moreinfo="none">%u</parameter>, 
+	<parameter moreinfo="none">%P</parameter> and <parameter moreinfo="none">%S</parameter>.
+	</para>
 </description>
 
 <value type="default"></value>
diff --git a/docs/smbdotconf/misc/magicoutput.xml b/docs/smbdotconf/misc/magicoutput.xml
index ed0cb0b21c..47e514fdce 100644
--- a/docs/smbdotconf/misc/magicoutput.xml
+++ b/docs/smbdotconf/misc/magicoutput.xml
@@ -4,14 +4,13 @@
 		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
 	<para>
-	This parameter specifies the name of a file 
-	which will contain output created by a magic script (see the 
+	This parameter specifies the name of a file which will contain output created by a magic script (see the 
 	<smbconfoption name="magic script"/> parameter below).
 	</para>
 
-<warning><para>If two clients use the same <parameter moreinfo="none">magic script
-	</parameter> in the same directory the output file content
-	is undefined.</para></warning>
+	<warning><para>If two clients use the same <parameter moreinfo="none">magic script
+	</parameter> in the same directory the output file content is undefined.
+	</para></warning>
 </description>
 
 <value type="default">&lt;magic script name&gt;.out</value>
diff --git a/docs/smbdotconf/misc/messagecommand.xml b/docs/smbdotconf/misc/messagecommand.xml
index 117600cf1d..91df58ab5d 100644
--- a/docs/smbdotconf/misc/messagecommand.xml
+++ b/docs/smbdotconf/misc/messagecommand.xml
@@ -11,9 +11,10 @@
 	deliver the message somehow. How this is to be done is 
 	up to your imagination.</para>
 
-	<para>An example is:</para>
-
-	<para><command moreinfo="none">message command = csh -c 'xedit %s;rm %s' &amp;</command>
+	<para>An example is:
+<programlisting>
+<command moreinfo="none">message command = csh -c 'xedit %s;rm %s' &amp;</command>
+</programlisting>
 	</para>
 
 	<para>This delivers the message using <command moreinfo="none">xedit</command>, then 
@@ -52,10 +53,12 @@
 	takes your fancy. Please let us know of any really interesting 
 	ideas you have.</para>
 
-	<para>Here's a way of sending the messages as mail to root:</para>
-
-	<para><command moreinfo="none">message command = /bin/mail -s 'message from %f on 
-	%m' root &lt; %s; rm %s</command></para>
+	<para>
+	Here's a way of sending the messages as mail to root:
+<programlisting>
+<command moreinfo="none">message command = /bin/mail -s 'message from %f on %m' root &lt; %s; rm %s</command>
+</programlisting>
+	</para>
 
 	<para>If you don't have a message command then the message 
 	won't be delivered and Samba will tell the sender there was 
@@ -63,9 +66,13 @@
 	and carries on regardless, saying that the message was delivered.
 	</para>
 
-	<para>If you want to silently delete it then try:</para>
-
-	<para><command moreinfo="none">message command = rm %s</command></para>
+	<para>
+	If you want to silently delete it then try:
+<programlisting>
+<command moreinfo="none">message command = rm %s</command>
+</programlisting>
+	</para>
+	
 </description>
 <value type="default"></value>
 <value type="example">csh -c 'xedit %s; rm %s' &amp;</value>
diff --git a/docs/smbdotconf/misc/panicaction.xml b/docs/smbdotconf/misc/panicaction.xml
index 85edad84e4..78f89fed99 100644
--- a/docs/smbdotconf/misc/panicaction.xml
+++ b/docs/smbdotconf/misc/panicaction.xml
@@ -8,7 +8,8 @@
 	system command to be called when either <citerefentry><refentrytitle>smbd</refentrytitle>
 	<manvolnum>8</manvolnum></citerefentry> or <citerefentry><refentrytitle>smbd</refentrytitle>
 	<manvolnum>8</manvolnum></citerefentry>	crashes. This is usually used to 
-draw attention to the fact that a problem occurred.</para>
+	draw attention to the fact that a problem occurred.
+	</para>
 </description>
 
 <value type="default"></value>
diff --git a/docs/smbdotconf/misc/piddirectory.xml b/docs/smbdotconf/misc/piddirectory.xml
index c4c3a2bf7d..c9f05338ac 100644
--- a/docs/smbdotconf/misc/piddirectory.xml
+++ b/docs/smbdotconf/misc/piddirectory.xml
@@ -4,8 +4,9 @@
                  advanced="1" developer="1"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>This option specifies the directory where pid 
-		files will be placed.  </para>
+	<para>
+	This option specifies the directory where pid files will be placed.  
+	</para>
 </description>
 
 <value type="default">${prefix}/var/locks</value>
diff --git a/docs/smbdotconf/misc/preexecclose.xml b/docs/smbdotconf/misc/preexecclose.xml
index c616ad7f07..7a477e16fe 100644
--- a/docs/smbdotconf/misc/preexecclose.xml
+++ b/docs/smbdotconf/misc/preexecclose.xml
@@ -4,8 +4,10 @@
 		 advanced="1" developer="1"
 		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>This boolean option controls whether a non-zero 
-	return code from <smbconfoption name="preexec"/> should close the service being connected to.</para>
+	<para>
+	This boolean option controls whether a non-zero return code from <smbconfoption name="preexec"/> 
+	should close the service being connected to.
+	</para>
 </description>
 
 <value type="default">no</value>
diff --git a/docs/smbdotconf/misc/remoteannounce.xml b/docs/smbdotconf/misc/remoteannounce.xml
index fc46a46e89..f4fe1d9538 100644
--- a/docs/smbdotconf/misc/remoteannounce.xml
+++ b/docs/smbdotconf/misc/remoteannounce.xml
@@ -4,28 +4,34 @@
 		 type="list"
 		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>This option allows you to setup <citerefentry><refentrytitle>nmbd</refentrytitle>
+	<para>
+	This option allows you to setup <citerefentry><refentrytitle>nmbd</refentrytitle>
 	<manvolnum>8</manvolnum></citerefentry>to periodically announce itself 
-	to arbitrary IP addresses with an arbitrary workgroup name.</para>
+	to arbitrary IP addresses with an arbitrary workgroup name.
+	</para>
 
-	<para>This is useful if you want your Samba server to appear 
-	in a remote workgroup for which the normal browse propagation 
-	rules don't work. The remote workgroup can be anywhere that you 
-	can send IP packets to.</para>
+	<para>
+	This is useful if you want your Samba server to appear in a remote workgroup for 
+	which the normal browse propagation rules don't work. The remote workgroup can be 
+	anywhere that you can send IP packets to.
+	</para>
 
-	<para>For example:</para>
+	<para>
+	For example:
+<programlisting>
+<command moreinfo="none">remote announce = 192.168.2.255/SERVERS 192.168.4.255/STAFF</command>
+</programlisting>
+	the above line would cause <command moreinfo="none">nmbd</command> to announce itself 
+	to the two given IP addresses using the given workgroup names. If you leave out the 
+	workgroup name then the one given in the <smbconfoption name="workgroup"/> parameter 
+	is used instead.
+	</para>
 
-	<para><command moreinfo="none">remote announce = 192.168.2.255/SERVERS 
-	192.168.4.255/STAFF</command></para>
-
-	<para>the above line would cause <command moreinfo="none">nmbd</command> to announce itself 
-	to the two given IP addresses using the given workgroup names. 
-	If you leave out the workgroup name then the one given in 
-	the <smbconfoption name="workgroup"/> parameter is used instead.</para>
-
-	<para>The IP addresses you choose would normally be the broadcast 
-	addresses of the remote networks, but can also be the IP addresses 
-	of known browse masters if your network config is that stable.</para>
+	<para>
+	The IP addresses you choose would normally be the broadcast addresses of the remote 
+	networks, but can also be the IP addresses of known browse masters if your network 
+	config is that stable.
+	</para>
 
 <para>See <smbconfoption name="NetworkBrowsing"/>.</para>
 </description>
diff --git a/docs/smbdotconf/misc/remotebrowsesync.xml b/docs/smbdotconf/misc/remotebrowsesync.xml
index ea25cf48c8..508ec3ab2e 100644
--- a/docs/smbdotconf/misc/remotebrowsesync.xml
+++ b/docs/smbdotconf/misc/remotebrowsesync.xml
@@ -4,32 +4,40 @@
 		 type="list"
 		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>This option allows you to setup <citerefentry><refentrytitle>nmbd</refentrytitle>
+	<para>
+	This option allows you to setup <citerefentry><refentrytitle>nmbd</refentrytitle>
         <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 
-	is done in a manner that does not work with any non-Samba servers.</para>
+	is done in a manner that does not work with any non-Samba servers.
+	</para>
 
-	<para>This is useful if you want your Samba server and all local 
+	<para>
+	This is useful if you want your Samba server and all local 
 	clients to appear in a remote workgroup for which the normal browse 
 	propagation rules don't work. The remote workgroup can be anywhere 
-	that you can send IP packets to.</para>
+	that you can send IP packets to.
+	</para>
 
-	<para>For example:</para>
-		
-	<para><command moreinfo="none">remote browse sync = 192.168.2.255 192.168.4.255</command></para>
-
-	<para>the above line would cause <command moreinfo="none">nmbd</command> to request 
+	<para>
+	For example:
+<programlisting>
+<command moreinfo="none">remote browse sync = 192.168.2.255 192.168.4.255</command>
+</programlisting>
+	the above line would cause <command moreinfo="none">nmbd</command> to request 
 	the master browser on the specified subnets or addresses to 
-	synchronize their browse lists with the local server.</para>
+	synchronize their browse lists with the local server.
+	</para>
 
-	<para>The IP addresses you choose would normally be the broadcast 
+	<para>
+	The IP addresses you choose would normally be the broadcast 
 	addresses of the remote networks, but can also be the IP addresses 
 	of known browse masters if your network config is that stable. If 
 	a machine IP address is given Samba makes NO attempt to validate 
 	that the remote machine is available, is listening, nor that it 
-	is in fact the browse master on its segment.</para>
+	is in fact the browse master on its segment.
+	</para>
 </description>
 
 <value type="default"></value>
diff --git a/docs/smbdotconf/misc/rootpostexec.xml b/docs/smbdotconf/misc/rootpostexec.xml
index 6fa003f085..4aff4f0334 100644
--- a/docs/smbdotconf/misc/rootpostexec.xml
+++ b/docs/smbdotconf/misc/rootpostexec.xml
@@ -4,10 +4,11 @@
 		 advanced="1" developer="1"
 		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>This is the same as the <parameter moreinfo="none">postexec</parameter>
-	parameter except that the command is run as root. This 
-	is useful for unmounting filesystems 
-	(such as CDROMs) after a connection is closed.</para>
+	<para>
+	This is the same as the <parameter moreinfo="none">postexec</parameter>
+	parameter except that the command is run as root. This is useful for 
+	unmounting filesystems (such as CDROMs) after a connection is closed.
+	</para>
 </description>
 
 <related>postexec</related>
diff --git a/docs/smbdotconf/misc/rootpreexec.xml b/docs/smbdotconf/misc/rootpreexec.xml
index 9f84b9f04d..89d10ec53b 100644
--- a/docs/smbdotconf/misc/rootpreexec.xml
+++ b/docs/smbdotconf/misc/rootpreexec.xml
@@ -4,10 +4,11 @@
 		 advanced="1" wizard="1" developer="1"
 		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>This is the same as the <parameter moreinfo="none">preexec</parameter>
-	parameter except that the command is run as root. This 
-	is useful for mounting filesystems (such as CDROMs) when a 
-	connection is opened.</para>
+	<para>
+	This is the same as the <parameter moreinfo="none">preexec</parameter>
+	parameter except that the command is run as root. This is useful for 
+	mounting filesystems (such as CDROMs) when a connection is opened.
+	</para>
 </description>
 
 <related>preexec</related>
diff --git a/docs/smbdotconf/misc/setdirectory.xml b/docs/smbdotconf/misc/setdirectory.xml
index 5859dddcbb..5e7b379a04 100644
--- a/docs/smbdotconf/misc/setdirectory.xml
+++ b/docs/smbdotconf/misc/setdirectory.xml
@@ -3,13 +3,16 @@
 			 type="boolean"
 		 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>If <command moreinfo="none">set directory = no</command>, then 
-	users of the service may not use the setdir command to change 
-	directory.</para>
+	<para>
+	If <command moreinfo="none">set directory = no</command>, then 	users of the 
+	service may not use the setdir command to change directory.
+	</para>
 
-	<para>The <command moreinfo="none">setdir</command> command is only implemented 
+	<para>
+	The <command moreinfo="none">setdir</command> command is only implemented 
 	in the Digital Pathworks client. See the Pathworks documentation 
-	for details.</para>
+	for details.
+	</para>
 </description>
 
 <value type="default">no</value>
diff --git a/docs/smbdotconf/misc/utmp.xml b/docs/smbdotconf/misc/utmp.xml
index f50b0794c7..d60a6e5bec 100644
--- a/docs/smbdotconf/misc/utmp.xml
+++ b/docs/smbdotconf/misc/utmp.xml
@@ -3,19 +3,20 @@
 				 type="boolean"
                  developer="1"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
- <description>
-	<para>This boolean parameter is only available if
-	Samba has been configured and compiled  with the option <command moreinfo="none">
-	--with-utmp</command>. If set to <constant>yes</constant> then Samba will attempt
-	to add utmp or utmpx records (depending on the UNIX system) whenever a
-	connection is made to a Samba server. Sites may use this to record the
-	user connecting to a Samba share.</para>
+<description>
+	<para>
+	This boolean parameter is only available if Samba has been configured and compiled  
+	with the option <command moreinfo="none">--with-utmp</command>. If set to 
+	<constant>yes</constant> then Samba will attempt to add utmp or utmpx records 
+	(depending on the UNIX system) whenever a connection is made to a Samba server. 
+	Sites may use this to record the user connecting to a Samba share.
+	</para>
 
-	<para>Due to the requirements of the utmp record, we
-	are required to create a unique identifier for the
-	incoming user.  Enabling this option creates an n^2
-	algorithm to find this number.  This may impede
-	performance on large installations. </para>
+	<para>
+	Due to the requirements of the utmp record, we 	are required to create a unique 
+	identifier for the incoming user.  Enabling this option creates an n^2 	algorithm 
+	to find this number.  This may impede performance on large installations. 
+	</para>
 </description>
 
 <related>utmp directory</related>
diff --git a/docs/smbdotconf/misc/wtmpdirectory.xml b/docs/smbdotconf/misc/wtmpdirectory.xml
index de7321d080..f58b522573 100644
--- a/docs/smbdotconf/misc/wtmpdirectory.xml
+++ b/docs/smbdotconf/misc/wtmpdirectory.xml
@@ -4,19 +4,17 @@
                  advanced="1" developer="1"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-	<para>This parameter is only available if Samba has 
-	been configured and compiled with the option <command moreinfo="none">
-	--with-utmp</command>. It specifies a directory pathname that is
-	used to store the wtmp or wtmpx files (depending on the UNIX system) that
-	record user connections to a Samba server. The difference with
-	the utmp directory is the fact that user info is kept after a user 
-	has logged out.</para>
+	<para>
+	This parameter is only available if Samba has been configured and compiled with the option <command moreinfo="none">
+	--with-utmp</command>. It specifies a directory pathname that is used to store the wtmp or wtmpx files (depending on 
+	the UNIX system) that record user connections to a Samba server. The difference with the utmp directory is the fact 
+	that user info is kept after a user has logged out.
+	</para>
 		
-<para>
- By default this is 
-	not set, meaning the system will use whatever utmp file the 
-	native system is set to use (usually 
-	<filename moreinfo="none">/var/run/wtmp</filename> on Linux).</para>
+	<para>
+	By default this is not set, meaning the system will use whatever utmp file the 	native system is set to use (usually 
+	<filename moreinfo="none">/var/run/wtmp</filename> on Linux).
+	</para>
 </description>
 
 <related>utmp</related>