summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJelmer Vernooij <jelmer@samba.org>2009-05-01 22:28:08 +0200
committerJelmer Vernooij <jelmer@samba.org>2009-05-01 22:49:14 +0200
commitd2650add2dcaa12e98ef6c5d98fb288225de9032 (patch)
treed8020b262ea6078aee971e1b02551e33bba1cac7
parentf04382344969440e50b84f3facdf8cbe1a44b427 (diff)
downloadsamba-d2650add2dcaa12e98ef6c5d98fb288225de9032.tar.gz
samba-d2650add2dcaa12e98ef6c5d98fb288225de9032.tar.xz
samba-d2650add2dcaa12e98ef6c5d98fb288225de9032.zip
Fix a couple of invalid DocBook XML usages in the Samba3 Developers Guide.
-rw-r--r--docs-xml/Samba3-Developers-Guide/index.xml8
-rw-r--r--docs-xml/Samba3-Developers-Guide/vfs.xml41
2 files changed, 25 insertions, 24 deletions
diff --git a/docs-xml/Samba3-Developers-Guide/index.xml b/docs-xml/Samba3-Developers-Guide/index.xml
index 0e5b688874..503fd22c11 100644
--- 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 96d512c8f3..f70fc96f37 100644
--- 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>