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

See commit notes