readme: simplify wording, add man! function design