Comments for main metadata cache calls

Author: AlexPeshkoff

src/jrd/met.h

@@ -371,6 +371,8 @@ class MetadataCache : public Firebird::PermanentStorage
 		return mdc_generators.lookup(id, name);
 	}
 
+	// Ensure old (current) version of object is loaded into cache
+
 	template <typename C>
 	static C* oldVersion(thread_db* tdbb, MetaId id, ObjectBase::Flag scanType)
 	{
@@ -379,20 +381,26 @@ class MetadataCache : public Firebird::PermanentStorage
 		return vrsn ? getPermanent(vrsn) : nullptr;
 	}
 
+	// Create new version of object in cache (if not exists)
+
 	template <typename C>
 	static C* newVersion(thread_db* tdbb, MetaId id)
 	{
 		auto& vector = Vector<C>::get(getCache(tdbb));
 		return vector.newVersion(tdbb, id);
 	}
 
+	// Mark object in cache as dropped
+
 	template <typename C>
 	static C* erase(thread_db* tdbb, MetaId id)
 	{
 		auto& vector = Vector<C>::get(getCache(tdbb));
 		return vector.erase(tdbb, id);
 	}
 
+	// Get versioned part of cached object by ID or name
+
 	template <typename C, typename V = C::Versioned>
 	static V* getVersioned(thread_db* tdbb, MetaId id, ObjectBase::Flag flags)
 	{
@@ -411,6 +419,8 @@ class MetadataCache : public Firebird::PermanentStorage
 		return rc;
 	}
 
+	// Get permanent part of cached object by ID or name
+
 	template <typename C>
 	static C* getPerm(thread_db* tdbb, MetaId id, ObjectBase::Flag flags)
 	{