doc: improve general documentation for MacOSX