docs-xml: mention that the man pages are "part of" version x
[sfrench/samba-autobuild/.git] / docs-xml / manpages / dbwrap_tool.1.xml
index 59ef968b978d4fb3df20fc13073d2af9e8d3c1ab..c2d9c306902e3421f451e68082f95e123b8cd507 100644 (file)
@@ -7,7 +7,7 @@
        <manvolnum>1</manvolnum>
        <refmiscinfo class="source">Samba</refmiscinfo>
        <refmiscinfo class="manual">System Administration tools</refmiscinfo>
-       <refmiscinfo class="version">4.0</refmiscinfo>
+       <refmiscinfo class="version">&doc.version;</refmiscinfo>
 </refmeta>
 
 
@@ -20,6 +20,7 @@
        <cmdsynopsis>
                <command>dbwrap_tool</command>
                <arg choice="opt">--persistent</arg>
+               <arg choice="opt">--non-persistent</arg>
                <arg choice="opt">-d &lt;debug level&gt;</arg>
                <arg choice="opt">-s &lt;config file&gt;</arg>
                <arg choice="opt">-l &lt;log file base&gt;</arg>
@@ -29,9 +30,7 @@
                <arg choice="req">&lt;operation&gt;</arg>
                <arg choice="opt">&lt;key&gt;
                        <arg choice="opt">&lt;type&gt;
-                               <arg choice="opt">&lt;value&gt;</arg>
-                       </arg>
-               </arg>
+                               <arg choice="opt">&lt;value&gt;</arg></arg></arg>
        </cmdsynopsis>
 </refsynopsisdiv>
 
@@ -49,6 +48,7 @@
                <listitem><para>fetch: fetch a record</para></listitem>
                <listitem><para>store: create or modify a record</para></listitem>
                <listitem><para>delete: remove a record</para></listitem>
+               <listitem><para>exists: test for existence of a record</para></listitem>
                <listitem><para>erase: remove all records</para></listitem>
                <listitem><para>listkeys: list all available records</para></listitem>
                <listitem><para>listwatchers: list processes, which are waiting for changes in a record</para></listitem>
                <varlistentry>
                        <term>--persistent</term>
                        <listitem><para>Open the database as a persistent database.
-                       If this option is not specified, the database is opened as
-                       non-persistent.
+                       </para>
+                       <para>
+                       Exactly one of --persistent and --non-persistent must be
+                       specified.
+                       </para></listitem>
+               </varlistentry>
+               <varlistentry>
+                       <term>--non-persistent</term>
+                       <listitem><para>Open the database as a non-persistent database.
+                       </para>
+                       <para>
+                       Caveat: opening a database as non-persistent when there
+                       is currently no other opener will wipe the database.
+                       </para>
+                       <para>
+                       Exactly one of --persistent and --non-persistent must be
+                       specified.
                        </para></listitem>
                </varlistentry>
                &popt.common.samba.client;
-               &stdarg.help;
+               &popt.autohelp;
        </variablelist>
 </refsect1>
 
                        <command>dbwrap_tool</command> &lt;database&gt; delete &lt;key&gt;
                </cmdsynopsis>
        </refsect2>
+       <refsect2>
+               <title>exists</title>
+               <cmdsynopsis>
+                       <command>dbwrap_tool</command> &lt;database&gt; exists &lt;key&gt;
+               </cmdsynopsis>
+       </refsect2>
        <refsect2>
                <title>erase</title>
                <cmdsynopsis>
 <refsect1>
        <title>VERSION</title>
 
-       <para>This man page is correct for version 3 of the Samba suite.</para>
+       <para>This man page is part of version &doc.version; of the Samba suite.</para>
 </refsect1>
 
 <refsect1>