Finish conversion of VFS options. This section is not complete yet -- we miss documentation for parametric options and new modules stuff

(This used to be commit 769bce45e9678b67e2ef1da84d5ee95c90357b9e)

6 files changed, 87 insertions, 75 deletions

diff --git a/docs/docbook/smbdotconf/vfs/hostmsdfs.xml b/docs/docbook/smbdotconf/vfs/hostmsdfs.xml
index 0496fd7f477..c843969e507 100644
--- a/docs/docbook/smbdotconf/vfs/hostmsdfs.xml
+++ b/docs/docbook/smbdotconf/vfs/hostmsdfs.xml
@@ -1,17 +1,20 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-		<term><anchor id="HOSTMSDFS"/>host msdfs (G)</term>
-		<listitem><para>This boolean parameter is only available 
-		if Samba has been configured and compiled with the <command moreinfo="none">
-		--with-msdfs</command> option. If set to <constant>yes</constant>, 
-		Samba will act as a Dfs server, and  allow Dfs-aware clients 
-		to browse Dfs trees hosted on the server.</para>
+<samba:parameter name="host msdfs"
+                 context="G"
+                 advanced="1" developer="1"
+                 xmlns:samba="http://samba.org/common">
+<listitem>
+	<para>This boolean parameter is only available 
+	if Samba has been configured and compiled with the <command moreinfo="none">
+	--with-msdfs</command> option. If set to <constant>yes</constant>, 
+	Samba will act as a Dfs server, and  allow Dfs-aware clients 
+	to browse Dfs trees hosted on the server.</para>
 
-		<para>See also the <link linkend="MSDFSROOT"><parameter moreinfo="none">
-		msdfs root</parameter></link> share  level  parameter.  For
-		more  information  on  setting  up a Dfs tree on Samba,
-		refer to <ulink url="msdfs_setup.html">msdfs_setup.html</ulink>.
-		</para>
+	<para>See also the <link linkend="MSDFSROOT"><parameter moreinfo="none">
+	msdfs root</parameter></link> share  level  parameter.  For
+	more  information  on  setting  up a Dfs tree on Samba,
+	refer to <ulink url="msdfs_setup.html">msdfs_setup.html</ulink>.
+	</para>
 		
-		<para>Default: <command moreinfo="none">host msdfs = no</command></para>
-		</listitem>
-		</samba:parameter>
+	<para>Default: <command moreinfo="none">host msdfs = no</command></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/vfs/msdfsproxy.xml b/docs/docbook/smbdotconf/vfs/msdfsproxy.xml
index 41b36cb91b2..c16968fda7b 100644
--- a/docs/docbook/smbdotconf/vfs/msdfsproxy.xml
+++ b/docs/docbook/smbdotconf/vfs/msdfsproxy.xml
@@ -1,15 +1,18 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-		<term><anchor id="MSDFSPROXY"/>msdfs proxy (S)</term>
-		<listitem><para>This parameter indicates that the share is a
-		stand-in for another CIFS share whose location is specified by
-		the value of the parameter. When clients attempt to connect to
-		this share, they are redirected to the proxied share using
-		the SMB-Dfs protocol.</para>
-		<para>Only Dfs roots can act as proxy shares. Take a look at the
-		<link linkend="MSDFSROOT"><parameter moreinfo="none">msdfs root</parameter></link>
-		and
-		<link linkend="HOSTMSDFS"><parameter moreinfo="none">host msdfs</parameter></link>
-		options to find out how to set up a Dfs root share.</para>
-		<para>Example: <command moreinfo="none">msdfs proxy = \\\\otherserver\\someshare</command></para>
-		</listitem>
-		</samba:parameter>
+<samba:parameter name="msdfs proxy"
+                 context="S"
+                 xmlns:samba="http://samba.org/common">
+<listitem>
+	<para>This parameter indicates that the share is a
+	stand-in for another CIFS share whose location is specified by
+	the value of the parameter. When clients attempt to connect to
+	this share, they are redirected to the proxied share using
+	the SMB-Dfs protocol.</para>
+
+	<para>Only Dfs roots can act as proxy shares. Take a look at the
+	<link linkend="MSDFSROOT"><parameter moreinfo="none">msdfs root</parameter></link>
+	and <link linkend="HOSTMSDFS"><parameter moreinfo="none">host msdfs</parameter></link>
+	options to find out how to set up a Dfs root share.</para>
+
+	<para>Example: <command moreinfo="none">msdfs proxy = \\\\otherserver\\someshare</command></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/vfs/msdfsroot.xml b/docs/docbook/smbdotconf/vfs/msdfsroot.xml
index dc50ba5e578..35142ff0377 100644
--- a/docs/docbook/smbdotconf/vfs/msdfsroot.xml
+++ b/docs/docbook/smbdotconf/vfs/msdfsroot.xml
@@ -1,19 +1,20 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-		<term><anchor id="MSDFSROOT"/>msdfs root (S)</term>
-		<listitem><para>This boolean parameter is only available if 
-		Samba is configured  and  compiled with the <command moreinfo="none">
-		--with-msdfs</command> option.  If set to <constant>yes</constant>, 
-		Samba treats the 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 moreinfo="none">msdfs:serverA\\shareA,serverB\\shareB</filename>
-		and so on.  For more information on setting up a Dfs tree 
-		on Samba,  refer to <ulink url="msdfs.html">&quot;Hosting a Microsoft 
-		Distributed File System tree on Samba&quot;</ulink> document.</para>
+<samba:parameter name="msdfs root"
+                 context="S"
+                 xmlns:samba="http://samba.org/common">
+<listitem>
+	<para>This boolean parameter is only available if 
+	Samba is configured  and  compiled with the <command moreinfo="none">
+	--with-msdfs</command> option.  If set to <constant>yes</constant>, 
+	Samba treats the 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 moreinfo="none">msdfs:serverA\\shareA,serverB\\shareB</filename>
+	and so on.  For more information on setting up a Dfs tree 
+	on Samba,  refer to <ulink url="msdfs.html">&quot;Hosting a Microsoft 
+	Distributed File System tree on Samba&quot;</ulink> document.</para>
 		
-		<para>See also <link linkend="HOSTMSDFS"><parameter moreinfo="none">host msdfs
-		</parameter></link></para>
+	<para>See also <link linkend="HOSTMSDFS"><parameter moreinfo="none">host msdfs</parameter></link></para>
 		
-		<para>Default: <command moreinfo="none">msdfs root = no</command></para>
-		</listitem>
-		</samba:parameter>
+	<para>Default: <command moreinfo="none">msdfs root = no</command></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/vfs/vfsobject.xml b/docs/docbook/smbdotconf/vfs/vfsobject.xml
index d334552dae9..c68e8d0135f 100644
--- a/docs/docbook/smbdotconf/vfs/vfsobject.xml
+++ b/docs/docbook/smbdotconf/vfs/vfsobject.xml
@@ -1,10 +1,12 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-		<term><anchor id="VFSOBJECT"/>vfs object (S)</term>
-		<listitem><para>This parameter specifies a shared object files that 
-		are used for Samba VFS I/O operations.  By default, normal 
-		disk I/O operations are used but these can be overloaded 
-		with one or more VFS objects. </para>
+<samba:parameter name="vfs object"
+                 context="S"
+                 xmlns:samba="http://samba.org/common">
+<listitem>
+	<para>This parameter specifies a shared object files that 
+	are used for Samba VFS I/O operations.  By default, normal 
+	disk I/O operations are used but these can be overloaded 
+	with one or more VFS objects. </para>
 		
-		<para>Default : <emphasis>no value</emphasis></para>
-		</listitem>
-		</samba:parameter>
+	<para>Default: <emphasis>no value</emphasis></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/vfs/vfsoptions.xml b/docs/docbook/smbdotconf/vfs/vfsoptions.xml
index 28f14a09bfb..d07ec461e2e 100644
--- a/docs/docbook/smbdotconf/vfs/vfsoptions.xml
+++ b/docs/docbook/smbdotconf/vfs/vfsoptions.xml
@@ -1,10 +1,12 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-		<term><anchor id="VFSOPTIONS"/>vfs options (S)</term>
-		<listitem><para>This parameter allows parameters to be passed 
-		to the vfs layer at initialization time. 
-		See also <link linkend="VFSOBJECT"><parameter moreinfo="none">
-		vfs object</parameter></link>.</para>
+<samba:parameter name="vfs options"
+                 context="S"
+                 xmlns:samba="http://samba.org/common">
+<listitem>
+	<para>This parameter allows parameters to be passed 
+	to the vfs layer at initialization time. 
+	See also <link linkend="VFSOBJECT"><parameter moreinfo="none">
+	vfs object</parameter></link>.</para>
 		
-		<para>Default : <emphasis>no value</emphasis></para>
-		</listitem>
-		</samba:parameter>
+	<para>Default: <emphasis>no value</emphasis></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/vfs/vfspath.xml b/docs/docbook/smbdotconf/vfs/vfspath.xml
index 78c27302a8a..c6718a00765 100644
--- a/docs/docbook/smbdotconf/vfs/vfspath.xml
+++ b/docs/docbook/smbdotconf/vfs/vfspath.xml
@@ -1,12 +1,13 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-		<term><anchor id="VFSPATH"/>vfs path (S)</term>
-		<listitem><para>This parameter specifies the directory
-		to look in for vfs modules. The name of every <command moreinfo="none">vfs object
-		</command> will be prepended by this directory
-		</para>
+<samba:parameter name="vfs path"
+                 context="S"
+                 xmlns:samba="http://samba.org/common">
+<listitem>
+	<para>This parameter specifies the directory
+	to look in for vfs modules. The name of every <command moreinfo="none">vfs object
+	</command> will be prepended by this directory.</para>
 
-		<para>Default: <command moreinfo="none">vfs path = </command></para>
-		<para>Example: <command moreinfo="none">vfs path = /usr/lib/samba/vfs</command></para>
+	<para>Default: <command moreinfo="none">vfs path = </command></para>
 
-		</listitem>
-		</samba:parameter>
+	<para>Example: <command moreinfo="none">vfs path = /usr/lib/samba/vfs</command></para>
+</listitem>
+</samba:parameter>