src/share/vm/gc/g1/g1RemSet.hpp

rev 9770 : imported patch 8145674-fix-includes-and-forward-declarations-in-g1remset-files
rev 9773 : imported patch 8145672-remove-dependency-of-g1fromcardcache-to-heapregionremset
rev 9774 : [mq]: 8145672-jmasa-comments

@@ -73,18 +73,19 @@
   // Used for caching the closure that is responsible for scanning
   // references into the collection set.
   G1ParPushHeapRSClosure** _cset_rs_update_cl;
 
 public:
-  // Gives an approximation on how many threads add records to a remembered set
-  // in parallel for sizing buffers to decrease performance losses due to sharing.
-  // Examples are mutator threads together with the concurrent refinement threads
-  // or GC threads.
+  // Gives an approximation on how many threads can be expected to add records to
+  // a remembered set in parallel. This can be used for sizing data structures to
+  // decrease performance losses due to data structure sharing.
+  // Examples for quantities that influence this value are the maximum number of
+  // mutator threads, maximum number of concurrent refinement or GC threads.
   static uint num_par_rem_sets();
 
-  // Initialize data that depends on a known heap size.
-  static void init_heap(uint max_regions);
+  // Initialize data that depends on that the heap size is known.
+  static void initialize(uint max_regions);
 
   // This is called to reset dual hash tables after the gc pause
   // is finished and the initial hash table is no longer being
   // scanned.
   void cleanupHRRS();