From df2d9be46687a392f6f91c2c9b869583bfbc34ac Mon Sep 17 00:00:00 2001
From: Jay Kwak <82421531+jkwak-work@users.noreply.github.com>
Date: Fri, 9 Aug 2024 10:10:21 -0700
Subject: [PATCH] Update build steps for MacOS

This commit adds a quick build step for MacOS on CONTRIBUTION.md.

It is unclear what are the conditions that slang-llvm needs to be
rebuilt locally. An issue is filed for it, #4812
---
 CONTRIBUTION.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/CONTRIBUTION.md b/CONTRIBUTION.md
index b043d96071..0b68e0ca04 100644
--- a/CONTRIBUTION.md
+++ b/CONTRIBUTION.md
@@ -105,6 +105,42 @@ Build with a following command:
 $ cmake --build --preset release
 ```
 
+#### MacOS
+Install XCode from AppStore.
+
+Install CMake and Ninja; we recommend using [homebrew](https://brew.sh/) for installing them.
+```
+brew install ninja
+brew install cmake
+```
+
+Run CMake with a following command to generate Makefile:
+```
+$ cmake --preset default
+```
+
+Build with a following command:
+```
+$ cmake --build --preset release
+```
+
+#### MacOS with slang-llvm local build
+slang-llvm is required to run slang-test properly.
+Depending on your hardware, your slang-llvm may need to be locally rebuilt with the following command.
+```
+external/build-llvm.sh --source-dir=build/slang-llvm_src --install-prefix=build/slang-llvm_install
+```
+
+You need to use the following command to re-generate Makefile,
+```
+$ cmake --preset default --fresh -DSLANG_SLANG_LLVM_FLAVOR=USE_SYSTEM_LLVM -DLLVM_DIR=build/slang-llvm_install/lib/cmake/llvm -DClang_DIR=build/slang-llvm_install/lib/cmake/clang
+```
+
+Build with a following command:
+```
+$ cmake --build --preset release
+```
+
 ### Making Changes
 Make your changes and ensure to follow our [Design Decisions](docs/design/README.md).