Copyedits and a couple of comments flagged with FIXME
Fairly significant rewriting and a query about the content of the example man page used.