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
***********