diff --git a/src/GrampsDb/_GrampsDbBase.py b/src/GrampsDb/_GrampsDbBase.py
index e314b7e1a..62a76afe5 100644
--- a/src/GrampsDb/_GrampsDbBase.py
+++ b/src/GrampsDb/_GrampsDbBase.py
@@ -2325,9 +2325,13 @@ class GrampsDbBase(GrampsDBCallback):
         return
 
     def report_bm_change(self):
+        """method that adds 1 to the number of bookmark changes during this session
+        """
         self._bm_changes += 1;
 
     def db_has_bm_changes(self):
+        """method that returns True if there where bookmark changes during the session
+        """
         return self._bm_changes > 0
         
 class Transaction:
diff --git a/src/GrampsDb/_GrampsInMemDB.py b/src/GrampsDb/_GrampsInMemDB.py
index 70ea4860b..63a7fbd79 100644
--- a/src/GrampsDb/_GrampsInMemDB.py
+++ b/src/GrampsDb/_GrampsInMemDB.py
@@ -380,6 +380,9 @@ class GrampsInMemDB(GrampsDbBase):
         return None
 
     def db_is_changed(self):
+        """return True if core data of database has changed in Memory
+             Note: this excludes most meta-data, you should check that separately
+        """
         return not self.readonly and \
               (len(self.undodb) > 0 or 
                 not self.abort_possible)