From 4ffdbc43f2ebce3757bfba080deab97c8500574d Mon Sep 17 00:00:00 2001
From: Jean-Francois Dockes <jf@dockes.org>
Date: Thu, 12 Apr 2018 16:40:22 +0200
Subject: [PATCH] doc

---
 src/doc/user/usermanual.html | 35 +++++++++++++++++++++++++++++++++
 src/doc/user/usermanual.xml  | 38 +++++++++++++++++++++++++++++++++++-
 2 files changed, 72 insertions(+), 1 deletion(-)

diff --git a/src/doc/user/usermanual.html b/src/doc/user/usermanual.html
index 0905ee21..ae01618a 100644
--- a/src/doc/user/usermanual.html
+++ b/src/doc/user/usermanual.html
@@ -5398,6 +5398,41 @@ alink="#0000FF">
         necessary in a different location, the index must be
         reset.</p>
       </div>
+      <p>To make a long story short, here follows a script to
+      create a <span class="application">Recoll</span>
+      configuration and index under a given directory (given as
+      single parameter). The resulting data set (files + recoll
+      directory) can later to be moved to a CDROM or thumb drive.
+      Longer explanations come after the script.</p>
+      <pre class="programlisting">#!/bin/sh
+
+fatal()
+{
+    echo $*;exit 1
+}
+usage()
+{
+    fatal "Usage: init-recoll-volume.sh &lt;top-directory&gt;"
+}
+
+test $# = 1 || usage
+topdir=$1
+test -d "$topdir" || fatal $topdir should be a directory
+
+confdir="$topdir/recoll-config"
+test ! -d "$confdir" || fatal $confdir should not exist
+
+mkdir "$confdir"
+cd "$topdir"
+topdir=`pwd`
+cd "$confdir"
+confdir=`pwd`
+
+(echo topdirs = '"'$topdir'"'; \
+ echo orgidxconfdir = $topdir/recoll-config) &gt; "$confdir/recoll.conf"
+
+recollindex -c "$confdir"
+</pre>
       <p>The examples below will assume that you have a dataset
       under <code class="filename">/home/me/mydata/</code>, with
       the index configuration and data stored inside <code class=
diff --git a/src/doc/user/usermanual.xml b/src/doc/user/usermanual.xml
index 53949c25..6a4946ac 100644
--- a/src/doc/user/usermanual.xml
+++ b/src/doc/user/usermanual.xml
@@ -4176,6 +4176,42 @@
     updated in its original location. If an update is necessary in a
     different location, the index must be reset.</para></note>
 
+    <para>To make a long story short, here follows a script to create a
+    &RCL; configuration and index under a given directory (given as single
+    parameter). The resulting data set (files + recoll directory) can later
+    to be moved to a CDROM or thumb drive. Longer explanations come after
+    the script.</para>
+    
+    <programlisting>#!/bin/sh
+
+fatal()
+{
+    echo $*;exit 1
+}
+usage()
+{
+    fatal "Usage: init-recoll-volume.sh &lt;top-directory>"
+}
+
+test $# = 1 || usage
+topdir=$1
+test -d "$topdir" || fatal $topdir should be a directory
+
+confdir="$topdir/recoll-config"
+test ! -d "$confdir" || fatal $confdir should not exist
+
+mkdir "$confdir"
+cd "$topdir"
+topdir=`pwd`
+cd "$confdir"
+confdir=`pwd`
+
+(echo topdirs = '"'$topdir'"'; \
+ echo orgidxconfdir = $topdir/recoll-config) > "$confdir/recoll.conf"
+
+recollindex -c "$confdir"
+</programlisting>
+    
     <para>The examples below will assume that you have a dataset under
     <filename>/home/me/mydata/</filename>, with the index configuration and
     data stored inside
@@ -4243,7 +4279,7 @@
     possible to run queries from a readonly configuration directory (with
     slightly reduced function of course, such as not recording the query
     history).</para>
-
+      
   </chapter>
 
   <chapter id="RCL.PROGRAM">