From 8affa377fb15a2d0e2471c370aca042642bd2f52 Mon Sep 17 00:00:00 2001 From: sideshowbarker Date: Fri, 26 Jul 2024 03:56:05 +0900 Subject: [PATCH] =?UTF-8?q?Documentation:=20Add=20guidance=20on=20?= =?UTF-8?q?=E2=80=9Ccan=E2=80=99t=20find=20Ninja=E2=80=9D=20error=20messag?= =?UTF-8?q?e?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/BuildInstructionsLadybird.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/Documentation/BuildInstructionsLadybird.md b/Documentation/BuildInstructionsLadybird.md index e3105c1d373..3e03ed5c4eb 100644 --- a/Documentation/BuildInstructionsLadybird.md +++ b/Documentation/BuildInstructionsLadybird.md @@ -197,6 +197,24 @@ brew install llvm CC=$(brew --prefix llvm)/bin/clang CXX=$(brew --prefix llvm)/bin/clang++ ./Meta/ladybird.sh run ``` +### Build error messages you may encounter + +The section lists out some particular error messages you may run into, and explains how to deal with them. + +#### Unable to find a build program corresponding to "Ninja" + +Solution to try: If you do in fact already have Ninja installed, then first try reinstalling Ninja. + +Details: If you see the message *“Unable to find a build program corresponding to "Ninja"”*, it’s likely not an indication that the build tooling can’t actually find Ninja, but instead an indication that the tooling found Ninja but it failed to run successfully. + +So, when you do run into that error message, the way to start figuring out what’s actually wrong is to try invoking Ninja manually, like this: + +``` +ninja -C Build/ladybird +``` + +Then, based on what output you get from that, you can troubleshoot the *actual* problem you’re running into — which may involve uninstalling your current Ninja install, and then re-installing it. + ### Resource files Ladybird requires resource files from the ladybird/Base/res directory in order to properly load