Recommend uv for running the analysis scripts

doc/hyperfine.1

@@ -153,7 +153,7 @@ arithmetics.
 .RS
 Example:
 .RS
-\fBhyperfine\fR \fB\-P\fR size 0 3 'sleep $((1 << {size}))'
+\fBhyperfine\fR \fB\-P\fR size 0 3 'sleep $((2**{size}))'
 .RE
 .RE
 .IP

scripts/README.md

@@ -4,23 +4,14 @@ This folder contains scripts that can be used in combination with hyperfines `--
 
 ```bash
 hyperfine 'sleep 0.020' 'sleep 0.021' 'sleep 0.022' --export-json sleep.json
-./plot_whisker.py sleep.json
+uv run plot_whisker.py sleep.json
 ```
 
 ### Pre-requisites
 
-To make these scripts work, you will need `numpy`, `matplotlib` and `scipy`.
+Install [`uv`](https://docs.astral.sh/uv/getting-started/installation/) and run the
+commands above from this directory.
 
-If you have a Python package manager that understands [PEP-723](https://peps.python.org/pep-0723/)
-inline script requirements like [`uv`](https://github.com/astral-sh/uv) or [`pipx`](https://github.com/pypa/pipx),
-you can directly run the scripts using
-
-```bash
-uv run plot_whisker.py sleep.json
-```
-
-Otherwise, install the dependencies via your system package manager or using `pip`:
-
-```bash
-pip install numpy matplotlib scipy  # pip3, if you are using python3
-```
+The scripts declare their dependencies using [PEP 723](https://peps.python.org/pep-0723/)
+inline script metadata. `uv run` automatically installs these dependencies in an
+isolated environment before running the script.

src/cli.rs

@@ -164,7 +164,7 @@ fn build_command() -> Command {
                      Example:  hyperfine -P threads 1 8 'make -j {threads}'\n\n\
                      This performs benchmarks for 'make -j 1', 'make -j 2', …, 'make -j 8'.\n\n\
                      To have the value increase following different patterns, use shell arithmetics.\n\n  \
-                     Example: hyperfine -P size 0 3 'sleep $((1 << {size}))'\n\n\
+                     Example: hyperfine -P size 0 3 'sleep $((2**{size}))'\n\n\
                      This performs benchmarks with power of 2 increases: 'sleep 1', 'sleep 2', 'sleep 4', …\n\
                      The exact syntax may vary depending on your shell and OS."
                 ),