Improvements to comments thanks to review

Author: maartenarnst

include/benchmark/benchmark.h

@@ -1206,9 +1206,9 @@ class BENCHMARK_EXPORT Benchmark {
   // Set the minimum relative accuracy to use to determine the required number
   // of iterations when running this benchmark. This option overrides
   // the `benchmark_min_rel_accuracy` flag.
-  // REQUIRES: `t > 0`, `Iterations` has not been called on this benchmark, and
+  // REQUIRES: `r > 0`, `Iterations` has not been called on this benchmark, and
   // time is measured manually, i.e., `UseManualTime` has been called on this
-  // benchmark and each benchmark iteration should call SetIterationTime(seconds)
+  // benchmark and each benchmark iteration should call `SetIterationTime(seconds)`
   // to report the measured time.
   Benchmark* MinRelAccuracy(double r);
 

src/benchmark.cc

@@ -89,8 +89,9 @@ BM_DEFINE_string(benchmark_min_time, kDefaultMinTimeStr);
 // Manual timers provide per-iteration times. The relative accuracy is
 // measured as the standard deviation of these per-iteration times divided by
 // the mean and the square root of the number of iterations. The benchmark is
-// run until the specified minimum time or number of iterations is reached
-// and the measured relative accuracy meets the specified requirement.
+// run until both of the following conditions are fulfilled:
+//   1. the specified minimum time or number of iterations is reached
+//   2. the measured relative accuracy meets the specified requirement
 BM_DEFINE_double(benchmark_min_rel_accuracy, 0.0);
 
 // Minimum number of seconds a benchmark should be run before results should be