Fix a couple of invalid DocBook XML usages in the Samba3 Developers Guide.

diff --git a/docs-xml/Samba3-Developers-Guide/index.xml b/docs-xml/Samba3-Developers-Guide/index.xml
index 0e5b688874b2e73d2a485d52d3d16fa91a834d1d..503fd22c111c8784f00d16175e4f82b18d225a01 100644 (file)
--- a/docs-xml/Samba3-Developers-Guide/index.xml
+++ b/docs-xml/Samba3-Developers-Guide/index.xml
@@ -35,10 +35,10 @@ distribution.  A copy can be found on-line at <ulink
 url="http://www.fsf.org/licenses/gpl.txt">http://www.fsf.org/licenses/gpl.txt</ulink>
 </para>
 
-<warning>
-       <para>This document is incomplete and unmaintained. It is merely a 
-       collection of development-related notes.</para>
-</warning>
+<para><warning>
+       This document is incomplete and unmaintained. It is merely a 
+       collection of development-related notes.
+</warning></para>
 
 </abstract>
 

diff --git a/docs-xml/Samba3-Developers-Guide/vfs.xml b/docs-xml/Samba3-Developers-Guide/vfs.xml
index 96d512c8f34a2f2f7f0f6daefedb8a8c7e5d71a4..f70fc96f37299efbd1f01391fd2177f095139623 100644 (file)
--- a/docs-xml/Samba3-Developers-Guide/vfs.xml
+++ b/docs-xml/Samba3-Developers-Guide/vfs.xml
@@ -59,14 +59,14 @@ parameters.
 
 <para>A VFS module has three major components:
 <itemizedlist>
-<listitem><emphasis>An initialization function</emphasis> that is
+       <listitem><para><emphasis>An initialization function</emphasis> that is
 called during the module load to register implemented
-operations.</listitem>
-<listitem><emphasis>An operations table</emphasis> representing a
+operations.</para></listitem>
+<listitem><para><emphasis>An operations table</emphasis> representing a
 mapping between statically defined module functions and VFS layer
-operations.</listitem>
-<listitem><emphasis>Module functions</emphasis> that do actual
-work.</listitem>
+operations.</para></listitem>
+<listitem><para><emphasis>Module functions</emphasis> that do actual
+               work.</para></listitem>
 </itemizedlist>
 </para>
 
@@ -93,11 +93,11 @@ corruption when accessing (changed) Samba structures.
 <para>Therefore, initialization function passes three parameters to the
 VFS registration function, <literal>smb_register_vfs()</literal>
 <itemizedlist>
-  <listitem><emphasis>interface version number</emphasis>, as constant
-  <literal>SMB_VFS_INTERFACE_VERSION</literal>, </listitem>
-  <listitem><emphasis>module name</emphasis>, under which Samba core
-  will know it, and</listitem>
-  <listitem><emphasis>an operations' table</emphasis>.</listitem>
+       <listitem><para><emphasis>interface version number</emphasis>, as constant
+                       <literal>SMB_VFS_INTERFACE_VERSION</literal>, </para></listitem>
+       <listitem><para><emphasis>module name</emphasis>, under which Samba core
+                       will know it, and</para></listitem>
+       <listitem><para><emphasis>an operations' table</emphasis>.</para></listitem>
 </itemizedlist>
 </para>
 
@@ -106,35 +106,36 @@ functions in the module would correspond to specific VFS operations
 and how those functions would co-operate with the rest of VFS
 subsystem. Each operation could perform in a following ways:
 <itemizedlist>
-  <listitem><emphasis>transparent</emphasis>, meaning that while
+       <listitem><para><emphasis>transparent</emphasis>, meaning that while
   operation is overriden, the module will still call a previous
   implementation, before or after its own action. This mode is
   indicated by the constant
-  <literal>SMB_VFS_LAYER_TRANSPARENT</literal>;
+  <literal>SMB_VFS_LAYER_TRANSPARENT</literal>;</para>
   </listitem>
-  <listitem><emphasis>opaque</emphasis>, for the implementations that
+  <listitem><para><emphasis>opaque</emphasis>, for the implementations that
   are terminating sequence of actions. For example, it is used to
   implement POSIX operation on top of non-POSIX file system or even
   not a file system at all, like a database for a personal audio
   collection. Use constant <literal>SMB_VFS_LAYER_OPAQUE</literal> for
-  this mode;</listitem>
-  <listitem><emphasis>splitter</emphasis>, a way when some file system
+  this mode;</para></listitem>
+  <listitem><para><emphasis>splitter</emphasis>, a way when some file system
   activity is done in addition to the transparently calling previous
   implentation. This usually involves mangling the result of that call
   before returning it back to the caller. This mode is selected by
-  <literal>SMB_VFS_LAYER_SPLITTER</literal> constant;</listitem>
-  <listitem><emphasis>logger</emphasis> does not change anything or
+  <literal>SMB_VFS_LAYER_SPLITTER</literal> constant;</para></listitem>
+  <listitem><para><emphasis>logger</emphasis> does not change anything or
   performs any additional VFS operations. When
   <emphasis>logger</emphasis> module acts, information about
   operations is logged somewhere using an external facility (or
   Samba's own debugging tools) but not the VFS layer. In order to
   describe this type of activity use constant
   <literal>SMB_VFS_LAYER_LOGGER</literal>;
+  </para>
   </listitem>
-  <listitem>On contrary, <emphasis>scanner</emphasis> module does call
+  <listitem><para>On contrary, <emphasis>scanner</emphasis> module does call
   other VFS operations while processing the data that goes through the
   system. This type of operation is indicated by the
-  <literal>SMB_VFS_LAYER_SCANNER</literal> constant.</listitem>
+  <literal>SMB_VFS_LAYER_SCANNER</literal> constant.</para></listitem>
 </itemizedlist>
 </para>