doc updates

Author: simonmichael

README.md

@@ -10,24 +10,24 @@ Quick & easy benchmarking of command-line programs.
 
 ## About
 
-quickbench is an update and repackaging of a benchmarking tool I've been 
+quickbench is an update and repackaging of a little benchmarking tool I've been 
 using in the hledger project since 2008.
-Use it like a more powerful "time" command for benchmarking general command-line programs,
+Use it like a more powerful "time" command for measuring the time taken by command-line programs,
 or for creating repeatable benchmark scripts for your projects.
 
 quickbench produces very simple output (elapsed seconds),
 as quickly as possible (running commands just once by default),
 and tabulates results from multiple executables.
 I find it very useful for quick and dirty, exploratory, and comparative measurements
-that I (and others) can understand at a glance.
+that you can understand at a glance.
 
 ## Examples
 
 Install it easily on most platforms with [stack](https://haskell-lang.org/get-started) (or cabal). 
 It's not yet on Hackage, so you'll need the source:
 
 ```
-$ git clone https://github.com/simonmichael/quickbench.git
+$ git clone https://github.com/simonmichael/quickbench
 $ cd quickbench
 $ stack install   # ensure $PATH includes ~/.local/bin
 ```
@@ -74,7 +74,7 @@ Best times:
 ```
 
 and run tests repeatedly to reduce or observe jitter. 
-(quickbench assumes the quickest measurement is the truest one):
+quickbench assumes the quickest measurement is the truest one:
 ```
 $ quickbench -w echo,expr -p5 -n100 -N2
 Running 1 tests 100 times with 2 executables at 2016-10-16 23:57:34.387764 UTC:

quickbench.1

@@ -10,8 +10,17 @@ quickbench \- quick & easy benchmarking of command\-line programs
 \f[C]quickbench\ [options]\ [<cmd>...]\f[]
 .SH DESCRIPTION
 .PP
-Runs some test commands, possibly with different executables, once or
-more and shows their best execution times in tabular format.
+quickbench runs some test commands, possibly with different executables,
+once or more and shows their best execution times in tabular format.
+.PP
+It produces very simple output (elapsed seconds), as quickly as possible
+(running commands just once by default), and tabulates results from
+multiple executables.
+I find it useful for quick and dirty, exploratory, and comparative
+.PD 0
+.P
+.PD
+measurements that you (and others) can understand at a glance.
 .PP
 Commands are specified as one or more quote\-enclosed arguments, and/or
 one per line in CMDSFILE; or read from a default file [./bench.sh].
@@ -119,9 +128,11 @@ easier.
 https://github.com/simonmichael/quickbench/issues
 .SH SEE ALSO
 .PP
-Home: https://github.com/simonmichael/quickbench
+Home page: https://github.com/simonmichael/quickbench
 .PP
 bench(1): https://github.com/Gabriel439/bench
+.PP
+time(1)
 .SH COPYRIGHT
 .PP
 Copyright (C) 2008\-2016 Simon Michael.

quickbench.1.md

@@ -108,7 +108,7 @@ https://github.com/simonmichael/quickbench/issues
 
 # SEE ALSO
 
-Home: https://github.com/simonmichael/quickbench
+Home page: https://github.com/simonmichael/quickbench
 
 bench(1): https://github.com/Gabriel439/bench