Add troubleshooting section to the site

[deemp]

Problem 1

Error

Preprocessing library for clock-0.8.4..
clock             > linking .stack-work/dist/aarch64-osx/ghc-9.6.4/build/System/Clock_hsc_make.o failed (exit code 1)
clock             > rsp file was: ".stack-work/dist/aarch64-osx/ghc-9.6.4/build/System/hsc2hscall14207-2.rsp"
...
error: ld: unknown option: -no_warn_duplicate_libraries

Environment

OS: macOS

pkgutil --pkg-info=com.apple.pkg.CLTools_Executables

package-id: com.apple.pkg.CLTools_Executables
version: 14.3.0.0.1.1679647830
volume: /
location: /
install-time: 1680602586

Solution

Update Xcode Command Line Tools to version 15.3 or newer (check the version in Stable release).
You can update the tools via Software Update in Settings or in a terminal:

softwareupdate --list
sudo softwareupdate --install --all

You'll probably need to update your system too.

Solution details

• The option no_warn_duplicate_libraries is passed here (link)
• There's a similar problem with Xcode of specific versions (link)
• xcode-select is an important program that allows applications to resolve paths to executables and libraries (link)
• xcode-select uses a new linker since the version 15 (link)