From 89f7640769f6a63fe662fc123670746d2b7fcce3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rapha=C3=ABl=20de=20Courville?=
 <raphael@processingfoundation.org>
Date: Fri, 7 Nov 2025 10:22:59 +0100
Subject: [PATCH] Update BUILD.md with build failure troubleshooting

Added troubleshooting steps for build failures related to permissions.
---
 BUILD.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/BUILD.md b/BUILD.md
index a7176776a..1216f2e95 100644
--- a/BUILD.md
+++ b/BUILD.md
@@ -163,3 +163,16 @@ You may see this warning in IntelliJ:
 > `Duplicate content roots detected: '.../processing4/java/src'`
 
 This happens because multiple modules reference the same source folder. It’s safe to ignore.
+
+
+### Build Failed
+
+If the build fails with `Permission denied` or `Could not copy file` errors, try cleaning the project.
+
+Run:
+
+```bash
+./gradlew clean
+```
+
+Then, rebuild the project.