* mu_store_needs_upgrade --> mu_store_versions_match

lib/mu-store-priv.hh

@@ -36,7 +36,7 @@
 
 class MuStoreError {
 public:
-	MuStoreError (MuError err, const std::string& what) :
+	MuStoreError (MuError err, const std::string& what):
 		_err (err), _what(what) {}
 	MuError mu_error () const { return _err; }
 	const std::string& what() const { return _what; }
@@ -79,10 +79,18 @@ public:
 
 		init (path, NULL, false, false);
 		_db = new Xapian::Database (path);
-		if (mu_store_needs_upgrade(this))
-			throw MuStoreError (MU_ERROR_XAPIAN_NOT_UP_TO_DATE,
-					    ("store needs an upgrade"));
 
+		if (!mu_store_versions_match(this)) {
+			char *errstr =
+				g_strdup_printf ("db version: %s, but we need %s; "
+						 "database rebuild is required",
+						 mu_store_version (this),
+						 MU_STORE_SCHEMA_VERSION);
+
+			MuStoreError exc (MU_ERROR_XAPIAN_VERSION_MISMATCH, errstr);
+			g_free (errstr);
+			throw exc;
+		}
 		MU_WRITE_LOG ("%s: opened %s read-only", __FUNCTION__, this->path());
 	}
 
@@ -122,8 +130,8 @@ public:
 					       MU_STORE_SCHEMA_VERSION, NULL);
 		else if (g_strcmp0 (version, MU_STORE_SCHEMA_VERSION) != 0) {
 			g_free (version);
-			throw MuStoreError (MU_ERROR_XAPIAN_NOT_UP_TO_DATE,
-					    "store needs an upgrade");
+			throw MuStoreError (MU_ERROR_XAPIAN_VERSION_MISMATCH,
+					    "the database needs a rebuild");
 		} else
 			g_free (version);
 	}

lib/mu-store-read.cc

@@ -118,17 +118,12 @@ mu_store_version (const MuStore *store)
 
 
 gboolean
-mu_store_needs_upgrade (const MuStore *store)
+mu_store_versions_match (const MuStore *store)
 {
 	g_return_val_if_fail (store, TRUE);
 
-	MU_WRITE_LOG ("'%s' '%s'\n", mu_store_version(store), MU_STORE_SCHEMA_VERSION);
-
-	if (g_strcmp0 (mu_store_version (store),
-		       MU_STORE_SCHEMA_VERSION) == 0)
-		return FALSE;
-	else
-		return TRUE;
+	return g_strcmp0 (mu_store_version (store),
+			  MU_STORE_SCHEMA_VERSION) == 0;
 }
 
 

lib/mu-store.h

@@ -353,14 +353,15 @@ gchar* mu_store_database_version (const gchar *xpath) G_GNUC_WARN_UNUSED_RESULT;
 
 
 /**
- * check whether the database needs to be upgraded, e.g., when it was
- * created with a different version of mu
+ * check whether the database schema's version is the same as the one
+ * that the current mu uses. If they are not the same, we'll need a
+ * database rebuild.
  *
  * @param store a MuStore instance
  *
- * @return TRUE if the database needs upgrading, FALSE otherwise
+ * @return TRUE if the versions are the same, FALSE otherwise.
  */
-gboolean mu_store_needs_upgrade (const MuStore *store);
+gboolean mu_store_versions_match (const MuStore *store);
 
 /**
  * clear the database, ie., remove all of the contents. This is a

lib/mu-util.h

@@ -437,7 +437,7 @@ enum _MuError {
 	/* xapian dir is not accessible */
 	MU_ERROR_XAPIAN_DIR_NOT_ACCESSIBLE    = 14,
 	/* database version is not up-to-date */
-	MU_ERROR_XAPIAN_NOT_UP_TO_DATE        = 15,
+	MU_ERROR_XAPIAN_VERSION_MISMATCH      = 15,
 	/* missing data for a document */
 	MU_ERROR_XAPIAN_MISSING_DATA          = 16,
 	/* database corruption */