issue #282: updated the documentation to cover Linux installs, and expanded it, especially the Mac part