src/hotspot/share/utilities/bitMap.hpp

rev 57101 : imported patch stufe_review

@@ -61,11 +61,12 @@
 
  private:
   bm_word_t* _map;     // First word in bitmap
   idx_t      _size;    // Size of bitmap (in bits)
 
-  // Limit max_size_in_bits so aligning up to a word never overflows.
+  // The maximum allowable size of a bitmap, in words or bits.
+  // Limit max_size_in_bits so aligning up to a word boundary never overflows.
   static idx_t max_size_in_words() { return raw_to_words_align_down(~idx_t(0)); }
   static idx_t max_size_in_bits() { return max_size_in_words() * BitsPerWord; }
 
   // Assumes relevant validity checking for bit has already been done.
   static idx_t raw_to_words_align_up(idx_t bit) {

@@ -156,15 +157,15 @@
 
   static void clear_range_of_words(bm_word_t* map, idx_t beg, idx_t end);
 
   // Verification.
 
-  // Verify size_in_bits does not exceed maximum size.
+  // Verify size_in_bits does not exceed max_size_in_bits().
   static void verify_size(idx_t size_in_bits) NOT_DEBUG_RETURN;
-  // Verify bit is less than size.
+  // Verify bit is less than size().
   void verify_index(idx_t bit) const NOT_DEBUG_RETURN;
-  // Verify bit is not greater than size.
+  // Verify bit is not greater than size().
   void verify_limit(idx_t bit) const NOT_DEBUG_RETURN;
   // Verify [beg,end) is a valid range, e.g. beg <= end <= size().
   void verify_range(idx_t beg, idx_t end) const NOT_DEBUG_RETURN;
 
   // Statistics.