diff --git a/doc/installation/source/macos.rst b/doc/installation/source/macos.rst index 9453f5443..208fa5654 100644 --- a/doc/installation/source/macos.rst +++ b/doc/installation/source/macos.rst @@ -43,11 +43,15 @@ Due to an `upstream limitation with Cppyy `_), or from Homebrew or MacPorts. + +macOS Xcode uses the Clang/LLVM compiler toolchain. It is possible to install the GNU compiler gcc/g++ from +Homebrew and MacPorts, but macOS will not provide it due to licensing issues. If you do not install Xcode you will have to install build tools via Homebrew or MacPorts. |ns3| works on recent versions of both ``clang++`` and ``g++``, so for macOS, there is no need to install ``g++``. +The following table provides package names for installing CMake and Ninja build system from Homebrew or MacPorts. + +--------------------+-------------------------------+-------------------------------------+ | **ns-3 Version** | **Homebrew packages** | **MacPorts packages** | +====================+===============================+=====================================+ @@ -56,6 +60,18 @@ to install ``g++``. | 3.35 and earlier | None | None | +--------------------+-------------------------------+-------------------------------------+ +You will know you are done when you can successfully type `clang++ -v` at the command line, and when you type `cmake --help` and it identifies that you have at least one installed generator (in the below example, Unix Makefiles): + +:: + + Generators + The following generators are available on this platform (* marks default): + * Unix Makefiles = Generates standard UNIX makefiles. + Ninja = Generates build.ninja files. + Ninja Multi-Config = Generates build-.ninja files. + Watcom WMake = Generates Watcom WMake makefiles. + Xcode = Generate Xcode project files. + Recommended ***********