--- a/src/hotspot/share/memory/metaspace/commitMask.hpp	Sat Nov 23 11:05:16 2019 +0100
+++ b/src/hotspot/share/memory/metaspace/commitMask.hpp	Mon Nov 25 16:35:14 2019 +0100
@@ -34,8 +34,9 @@
 
 namespace metaspace {
 
-// A bitmap covering a range of metaspace; each bit in this mask corresponds to
-//
+// The CommitMask describes the committed-ness of a metaspace range.
+//  One bit corresponds to a commit granule.
+//  1 means the area is committed; 0 means it is uncommitted.
 class CommitMask : public CHeapBitMap {
 
   const MetaWord* const _base;
@@ -117,6 +118,7 @@
 
 public:
 
+  // Create a commit mask covering a range [start, start + word_size).
   CommitMask(const MetaWord* start, size_t word_size);
 
   const MetaWord* base() const  { return _base; }