From 83ee11fa3f6992f1dc30c8cee6481ccc1c33345d Mon Sep 17 00:00:00 2001
From: dockes <none@none>
Date: Sat, 27 Oct 2007 16:40:57 +0000
Subject: [PATCH] comment

---
 src/rcldb/rcldb.cpp | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/rcldb/rcldb.cpp b/src/rcldb/rcldb.cpp
index 4f8656db..7b3e5f2d 100644
--- a/src/rcldb/rcldb.cpp
+++ b/src/rcldb/rcldb.cpp
@@ -1,5 +1,5 @@
 #ifndef lint
-static char rcsid[] = "@(#$Id: rcldb.cpp,v 1.127 2007-10-27 08:39:24 dockes Exp $ (C) 2004 J.F.Dockes";
+static char rcsid[] = "@(#$Id: rcldb.cpp,v 1.128 2007-10-27 16:40:57 dockes Exp $ (C) 2004 J.F.Dockes";
 #endif
 /*
  *   This program is free software; you can redistribute it and/or modify
@@ -1202,14 +1202,14 @@ bool Db::needUpdate(const string &filename, const struct stat *stp)
     string pterm  = "P" + hash;
     string ermsg;
 
-    // Look for all documents with this path. We need to look at all
-    // to set their existence flag.  We check the update time on the
-    // fmtime field which will be identical for all docs inside a
-    // multi-document file (we currently always reindex all if the
-    // file changed)
+    // We look up the document indexed by the Pterm. This is either
+    // the actual document file, or, for a multi-document file, the
+    // pseudo-doc we create to stand for the file itself.
+
+    // We try twice in case database needs to be reopened.
     for (int tries = 0; tries < 2; tries++) {
 	try {
-	    // Check the date using the Pterm doc or pseudo-doc
+	    // Get the Pterm doc or pseudo-doc
 	    Xapian::PostingIterator docid = m_ndb->db.postlist_begin(pterm);
 	    if (docid == m_ndb->db.postlist_end(pterm)) {
 		// If no document exist with this path, we do need update