Documentation for installing AdaptiveCpp on macbook Pro M1

[adi-lb-phoenix]

Documentation for installing AdaptiveCpp on macbook Pro M1 with reference to #1433

[illuhad]

Thank you. Perhaps some of our users with Mac experience (@normallytangent ?) can comment on the documented steps.

It might be a good idea to also enable the SSCP compiler and document how to set things up with LLVM. The SSCP JIT compiler for host CPU I think should work on Mac.

At a higher level, I think the most important question is how this content would fit into the existing documentation. This PR just provides a text file that is referenced from nowhere, which makes it questionable whether it would be found by users. We could add some structure to cover different OS. Or, we do the same what we do currently with Windows and document the steps for Mac in a Wiki-page (https://github.com/AdaptiveCpp/AdaptiveCpp/wiki/Using-AdaptiveCpp-on-Windows).

[adi-lb-phoenix]

@illuhad Thank you for the reply .
I think its better if documentation related to macOS can be replicated for how its done with windows as you suggested , because installing and running the application should not be cumbersome . Also the documentation related to macOS that's already existing was not complete enough . I will push the changes soon and keep you posted .
why do you suggest the idea "it might be a good idea to also enable the SSCP compiler " ?

[illuhad]

why do you suggest the idea "it might be a good idea to also enable the SSCP compiler " ?

Because the SSCP JIT compiler (--acpp-targets=generic) is our default and most powerful compiler. It can also target the host CPU and in principle it should be able to run on Mac. So ideally, we can verify that it works and then also recommend people to use it on Mac. We are already heavily pushing Linux users towards using the SSCP compiler.

We should first enable it in Ma CI though; @fodinabor recently tried this and discovered some hiccups.