fixed magic method documentation, added comment in Makefile
update documentation about installing on OSX