From f1e9e846f16fb744f301ef6a290d1d1a7edf813c Mon Sep 17 00:00:00 2001
From: DraVee <dravee@eden-emu.dev>
Date: Sun, 22 Feb 2026 05:29:57 +0100
Subject: [PATCH] [docs] Add Gentoo and Arch Linux packages to GDB instructions
 (#3521)

Reviewed-on: https://git.eden-emu.dev/eden-emu/eden/pulls/3521
Reviewed-by: crueter <crueter@eden-emu.dev>
Reviewed-by: CamilleLaVey <camillelavey99@gmail.com>
Co-authored-by: DraVee <dravee@eden-emu.dev>
Co-committed-by: DraVee <dravee@eden-emu.dev>
---
 docs/Debug.md | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/docs/Debug.md b/docs/Debug.md
index f338bc1eeb..f384918fe2 100644
--- a/docs/Debug.md
+++ b/docs/Debug.md
@@ -29,10 +29,18 @@ Ignoring SIGSEGV when debugging in host:
 
 ### gdb
 
-Run `./build/bin/eden-cli -c <path to your config file (see logs where you run eden normally to see where it is)> -d -g <path to game>`
+You must have GDB installed for aarch64 to debug the target. Install it through your package manager, e.g.:
+* On Arch:
+  * `sudo pacman -Syu aarch64-linux-gnu-gdb`
+* On Gentoo:
+  * `sudo emerge --ask crossdev`
+  * `sudo crossdev -t aarch64-unknown-linux-gnu --ex-gdb`
 
-Then hook up an aarch64-gdb (use `yay aarch64-gdb` or `sudo pkg in arch64-gdb` to install)
-Then type `target remote localhost:1234` and type `c` (for continue) - and then if it crashes just do a `bt` (backtrace) and `layout asm`.
+Run `./build/bin/eden-cli -c <path to your config file (see logs where you run eden normally to see where it is)> -d -g <path to game>`
+Or `Enable GDB Stub` at General > Debug, then hook up an aarch64-gdb:
+* `target remote localhost:6543`
+
+Type `c` (for continue) and then if it crashes just do a `bt` (backtrace) and `layout asm`
 
 ### gdb cheatsheet