diff base/TempDirectory.h @ 460:93fb1ebff76b

* Add persistent cache file support to FileSource (e.g. for RDF descriptions) * Query RDF plugin data in a background thread on startup
author Chris Cannam
date Fri, 17 Oct 2008 13:32:55 +0000
parents 82f529a08cf3
children fbe8afdfa8a6
line wrap: on
line diff
--- a/base/TempDirectory.h	Thu Oct 16 13:38:33 2008 +0000
+++ b/base/TempDirectory.h	Fri Oct 17 13:32:55 2008 +0000
@@ -38,17 +38,36 @@
     virtual ~TempDirectory();
 
     /**
+     * Return the path of the directory in which the temporary
+     * directory has been or will be created.  This directory is
+     * particular to this application, although not to this instance
+     * of it, and it will not be removed when the application exits.
+     * Persistent cache data or similar may be placed in this
+     * directory or other, non-temporary subdirectories of it.
+     *
+     * If this directory does not exist, it will be created.  Throw
+     * DirectoryCreationFailed if the directory cannot be created.
+     */
+    QString getContainingPath();
+
+    /**
      * Create the root temporary directory if necessary, and return
-     * its path.  Throw DirectoryCreationFailed if the directory
-     * cannot be created.
+     * its path.  This directory will be removed when the application
+     * exits.
+     *
+     * Throw DirectoryCreationFailed if the directory cannot be
+     * created.
      */
     QString getPath();
 
     /** 
      * Create an immediate subdirectory of the root temporary
      * directory of the given name, if it doesn't already exist, and
-     * return its path.  Throw DirectoryCreationFailed if the
-     * directory cannot be created.
+     * return its path.  This directory will be removed when the
+     * application exits.
+     * 
+     * Throw DirectoryCreationFailed if the directory cannot be
+     * created.
      */
     QString getSubDirectoryPath(QString subdir);