Update the manpage extensively.

Updates are for three purposes: (1) to correct inaccuracies, (2) to
document things previously not documented, and (3) to improve
readability.