docs-xml:vfs_preopen.8: improve the documentation of the current detection algorithm

We should be more verbose that the first digits in a name are taken by
default, if at least 3 digits were found.

There might be cases were the last group of digits describe the
increasing frame number, while the fixed name already contains
3 digits. This is currently not supported.

It's also possible to provide more than one pattern.

Signed-off-by: Stefan Metzmacher <metze@samba.org>
Reviewed-by: Ralph Boehme <slow@samba.org>

diff --git a/docs-xml/manpages/vfs_preopen.8.xml b/docs-xml/manpages/vfs_preopen.8.xml
index f9f3d60a02a168186f1a9418024cf044c2fb2d22..3c799b62190cada0433133c5f4e2e8df58c09888 100644 (file)
--- a/docs-xml/manpages/vfs_preopen.8.xml
+++ b/docs-xml/manpages/vfs_preopen.8.xml
@@ -49,14 +49,16 @@
        <variablelist>
 
                <varlistentry>
-               <term>preopen:names = /pattern/</term>
+               <term>preopen:names = /pattern1/pattern2/</term>
                <listitem>
                <para>
-               preopen:names specifies the file name pattern which should
+               preopen:names specifies the file name pattern(s) which should
                trigger the preopen helpers to do their work. We assume that
                the files are numbered incrementally. So if your file names
                are numbered FRAME00000.frm FRAME00001.frm and so on you would
-               list them as <command>preopen:names=/FRAME*.frm/</command>
+               list them as <command>preopen:names=/FRAME*.frm/</command>.
+               The current algorithm uses the first (at least 3) digits it finds
+               in order to calculate the name of the next frames.
                </para>
                </listitem>
                </varlistentry>