OS X instructions (mostly), conform to avatar standard, and a bugfix

See commit notes
Fixes #318 (mostly)