improved man page

fleshing out man page (previously moved to section 8)