From 749881a92fd49c5aab17101e8b0d1d68ae598a14 Mon Sep 17 00:00:00 2001
From: d-millar <33498836+d-millar@users.noreply.github.com>
Date: Fri, 5 Jul 2024 12:01:48 -0400
Subject: [PATCH] GP-0: warnings for lldb users

---
 .../InstructionsForBuildingLLDBInterface.txt             | 5 +++++
 Ghidra/Debug/Debugger-swig-lldb/buildNatives.gradle      | 9 +++++----
 .../macos_debugger_lldb_build_from_brew.sh               | 8 ++++++++
 3 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/Ghidra/Debug/Debugger-swig-lldb/InstructionsForBuildingLLDBInterface.txt b/Ghidra/Debug/Debugger-swig-lldb/InstructionsForBuildingLLDBInterface.txt
index 38521d2e9e..3ad0fc85ae 100644
--- a/Ghidra/Debug/Debugger-swig-lldb/InstructionsForBuildingLLDBInterface.txt
+++ b/Ghidra/Debug/Debugger-swig-lldb/InstructionsForBuildingLLDBInterface.txt
@@ -1,3 +1,8 @@
+######################################################################################
+## PLEASE NOTE: This version of the lldb-based debugger is being deprecated.        ##
+##   Please try the Python-based traceRMI versions documented in the Debugger help. ##
+######################################################################################
+
 To use the LLDB agent in Ghidra, you will need to build the JNI interface to the LLDB Scripting Bridge.
 
 If you are using the distribution (vs. source) and wish to use the default swig files included (LLDB v17), you can use the
diff --git a/Ghidra/Debug/Debugger-swig-lldb/buildNatives.gradle b/Ghidra/Debug/Debugger-swig-lldb/buildNatives.gradle
index d72dceb1de..47fb48ff61 100644
--- a/Ghidra/Debug/Debugger-swig-lldb/buildNatives.gradle
+++ b/Ghidra/Debug/Debugger-swig-lldb/buildNatives.gradle
@@ -44,11 +44,12 @@ task generateSwig {
 		    		"-outdir", "$outdir_java/SWIG", "-o", "$outdir_cpp/LLDBWrapJava.cpp" 
 				args "$srcdir/java.swig"
 			}
-		} else if (llvmRequired) {
-            throw new GradleException("Debugger-swig-lldb:generateSwig requires LLVM_HOME to be defined")
 		} else {
-			println "Debugger-swig-lldb:generateSwig skipped - LLVM_HOME not defined"
-		}
+            //throw new GradleException("Debugger-swig-lldb:generateSwig requires LLVM_HOME to be defined")
+			println "OPTIONAL dependency Debugger-swig-lldb:generateSwig skipped - LLVM_HOME not defined"
+			println "NOTE: The JNI/swig interface for recorder-style lldb debugging is being deprecated."
+			println "      Please try the new traceRMI python-based versions of the debugger."
+		} 
 	}
 }
 
diff --git a/Ghidra/Debug/Debugger-swig-lldb/macos_debugger_lldb_build_from_brew.sh b/Ghidra/Debug/Debugger-swig-lldb/macos_debugger_lldb_build_from_brew.sh
index e54d4f905a..1061f780c2 100755
--- a/Ghidra/Debug/Debugger-swig-lldb/macos_debugger_lldb_build_from_brew.sh
+++ b/Ghidra/Debug/Debugger-swig-lldb/macos_debugger_lldb_build_from_brew.sh
@@ -13,6 +13,14 @@
 #  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
+##
+
+######################################################################################
+## PLEASE NOTE: This version of the lldb-based debugger is being deprecated.        ##
+##   Please try the Python-based traceRMI versions documented in the Debugger help. ##
+######################################################################################
+
+
 ##
 # This script will download lldb from homebrew and
 # build the Ghidra JNI bindings for this version of