Describe the default benchmark duration as an estimate

README.md

@@ -33,8 +33,9 @@ hyperfine 'sleep 0.3'
 ```
 
 Hyperfine will automatically determine the number of runs to perform for each command. By default,
-it will perform *at least* 10 benchmarking runs and measure for at least 3 seconds. To change this,
-you can use the `-r`/`--runs` option:
+it will perform *at least* 10 benchmarking runs and estimate a run count targeting roughly
+3 seconds, including shell overhead and preparation and conclusion commands. To set an exact
+number of runs, you can use the `-r`/`--runs` option:
 ```sh
 hyperfine --runs 5 'sleep 0.3'
 ```

doc/hyperfine.1

@@ -3,8 +3,7 @@
 hyperfine \- command\-line benchmarking tool
 .SH SYNOPSIS
 .B hyperfine
-.RB [ \-hVN ]
-.RB [ \-\-ignore\-failure[=MODE] ]
+.RB [ \-ihVN ]
 .RB [ \-\-warmup
 .IR NUM ]
 .RB [ \-\-min\-runs
@@ -15,10 +14,6 @@ hyperfine \- command\-line benchmarking tool
 .IR NUM ]
 .RB [ \-\-setup
 .IR CMD ]
-.RB [ \-\-reference
-.IR CMD ]
-.RB [ \-\-reference\-name
-.IR NAME ]
 .RB [ \-\-prepare
 .IR CMD ]
 .RB [ \-\-conclude
@@ -114,16 +109,6 @@ for compiling your software or with the provided parameters, or to do any
 other work that should happen once before a series of benchmark runs,
 not every time as would happen with the \fB\-\-prepare\fR option.
 .HP
-\fB\-\-reference\fR \fICMD\fP
-.IP
-Benchmark \fICMD\fP as the reference for the relative comparison of results.
-If this option is not specified, the fastest command is used as the reference.
-.HP
-\fB\-\-reference\-name\fR \fINAME\fP
-.IP
-Give a meaningful \fINAME\fP to the reference command.
-Requires \fB\-\-reference\fR.
-.HP
 \fB\-p\fR, \fB\-\-prepare\fR \fICMD...\fP
 .IP
 Execute \fICMD\fP before each timing run. This is useful for clearing disk caches,
@@ -222,13 +207,9 @@ things like "sleep 0.1; sleep 0.2" are not possible without a shell.
 .IP
 An alias for '\-\-shell=none'.
 .HP
-\fB\-i\fR, \fB\-\-ignore\-failure\fR[=\fIMODE\fP]
+\fB\-i\fR, \fB\-\-ignore\-failure\fR
 .IP
-Ignore failures of the benchmarked programs. Without a value or with
-\fBall\-non\-zero\fR, all non\-zero exit codes are ignored.
-Alternatively, provide a comma\-separated list of exit codes to ignore,
-for example \fB\-\-ignore\-failure=1,2\fR.
-An explicit value must be attached to the option with an equals sign.
+Ignore non\-zero exit codes of the benchmarked programs.
 .HP
 \fB\-\-style\fR \fITYPE\fP
 .IP