Add cachedir variable allowing to move all data directories by setting a single value. Closes issue #270

src/sampleconf/recoll.conf

@@ -153,10 +153,21 @@ maxTermExpand = 10000
 # eating all the memory. Default 50000
 maxXapianClauses = 50000
 
+# Recoll data directories are normally stored relative to the configuration
+# directory (e.g. ~/.recoll/xapiandb, ~/.recoll/mboxcache). If this is set,
+# the directories are stored under the specified value instead
+# (e.g. if cachedir is ~/.cache/recoll, the default dbdir would be
+# ~/.cache/recoll/xapiandb).
+# This affects dbdir, webcachedir, mboxcachedir, aspellDicDir, which can
+# still be individually specified to override cachedir.
+# Note that if you have multiple configurations, each must have a different
+# cachedir, there is no automatic computation of a subpath under cachedir.
+#cachedir = ~/.cache/recoll
+
 # Where to store the database (directory). This may be an absolute path,
-# else it is taken as relative to the configuration directory (-c argument
-# or $RECOLL_CONFDIR). 
-# If nothing is specified, the default is then ~/.recoll/xapiandb/
+# else it is taken as relative to cachedir if set, or the configuration
+# directory (-c argument or $RECOLL_CONFDIR).  If nothing is specified, the
+# default is then ~/.recoll/xapiandb/
 dbdir = xapiandb
 
 # Indexing process threads configuration. If Recoll is configured for 
@@ -289,6 +300,11 @@ filtermaxmbytes = 2000
 # Jessie). See Debian bug 772415
 # aspellAddCreateParam = --local-data-dir=/usr/lib/aspell
 
+# The aspell dictionary (aspdict.(lang).rws) is normally stored in the
+# directory specified by cachedir if set, or under the configuration
+# directory. Set the following to change: 
+#aspellDicDir = 
+
 # You may also want to set this to have a look at aspell dictionary
 # creation errors. But there are always many, so this is mostly for debugging
 # aspellKeepStderr = 1
@@ -329,7 +345,7 @@ processwebqueue = 0
 #webqueuedir = ~/.recollweb/ToIndex
 # This is only used by the web history indexing code, and
 # defines where the cache for visited pages will live. Default:
-# $RECOLL_CONFDIR/webcache 
+# cachedir/webcache if cachedir is set, else $RECOLL_CONFDIR/webcache 
 webcachedir = webcache
 # This is only used by the web history indexing code, and
 # defines the maximum size for the web page cache. Default: 40 MB.
@@ -337,7 +353,8 @@ webcachedir = webcache
 webcachemaxmbs = 40
 
 # The directory where mbox message offsets cache files are held. This is
-# normally $RECOLL_CONFDIR/mboxcache, but it may be useful to share a
+# normally named mboxcache under cachedir if set, or else under the
+# configuration directory, but it may be useful to share a
 # directory between different configurations. 
 #mboxcachedir = mboxcache