huge update to the man page and readme, closes #180