src/share/vm/gc/shared/workgroup.hpp

rev 11389 : 8157620: Guarantee in run_task(task, num_workers) fails
Reviewed-by:
rev 11390 : [mq]: code_review1

@@ -168,11 +168,11 @@
   }
 
   // Add GC workers as needed.
   void add_workers(bool initializing);
 
-  // Add specified number of GC workers
+  // Add GC workers as needed to reach the specified number of workers.
   void add_workers(uint active_workers, bool initializing);
 
   // Return the Ith worker.
   AbstractGangWorker* worker(uint i) const;
 

@@ -215,11 +215,12 @@
 
   // Run a task using the current active number of workers, returns when the task is done.
   virtual void run_task(AbstractGangTask* task);
   // Run a task with the given number of workers, returns
   // when the task is done. The number of workers must be at most the number of
-  // active workers.
+  // active workers.  Additional workers may be created if an insufficient
+  // number currently exists.
   void run_task(AbstractGangTask* task, uint num_workers);
 
 protected:
   virtual AbstractGangWorker* allocate_worker(uint which);
 };