diff --git a/BUILD.md b/BUILD.md index 66af9725a2..e982490e21 100644 --- a/BUILD.md +++ b/BUILD.md @@ -368,6 +368,35 @@ The workaround for this error is to add two lines to your profile: tools.build:cxxflags=['-DBOOST_ASIO_DISABLE_CONCEPTS'] ``` +### Set Up Ccache + +To speed up repeated compilations, we recommend that you install +[ccache](https://ccache.dev), a tool that wraps your compiler so that it can +cache build objects locally. + +#### Linux + +You can install it using the package manager, e.g. `sudo apt install ccache` +(Ubuntu) or `sudo dnf install ccache` (RHEL). + +#### macOS + +You can install it using Homebrew, i.e. `brew install ccache`. + +#### + +You can install it using Chocolatey, i.e. `choco install ccache`. However, if +you see an error such as: + +``` +terminate called after throwing an instance of 'std::bad_alloc' + what(): std::bad_alloc +C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Microsoft\VC\v170\Microsoft.CppCommon.targets(617,5): error MSB6006: "cl.exe" exited with code 3. +``` + +then the latest version of Ccache still has not been fixed. In that case please +install it via: `choco install ccache --version 4.11.3 --allow-downgrade`. + ### Build and Test 1. Create a build directory and move into it.