move stuff out of README and into manual pages