[gnome-boxes.wiki] Update Debugging Crashes page



commit 3a21604ab947ab375d748024ef8c497f03a24d06
Author: Felipe Borges <felipeborges gnome org>
Date:   Tue Nov 30 11:03:35 2021 +0000

    Update Debugging Crashes page

 Debugging-Crashes.md | 63 ++++++++++++++++++++++------------------------------
 1 file changed, 26 insertions(+), 37 deletions(-)
---
diff --git a/Debugging-Crashes.md b/Debugging-Crashes.md
index 481b86e..c64b3d3 100644
--- a/Debugging-Crashes.md
+++ b/Debugging-Crashes.md
@@ -1,26 +1,24 @@
 We support two building methods, classic and Flatpak.
 
-# 1. Debugging a local install
+# Debugging a local install (classic)
 
-## 1.1 Install debug symbols
+Install the [debug symbol packages for your 
distribution](https://wiki.gnome.org/GettingInTouch/Bugzilla/GettingTraces).
 
-In Fedora/RHEL/CentOS, run:
+ * Run Boxes with gdb with `gdb gnome-boxes`
+ * On the gdb console, enter `run`.
 
-`$ sudo dnf debuginfo-install gnome-boxes`
+# Flatpak
 
-## 1.2 Install gdb
+ * Install the debug symbols
 
-In Fedora/RHEL/CentOS, run:
-
-`$ sudo dnf install gdb`
-
-## 1.3 Run Boxes with gdb
-
-$ gdb gnome-boxes
-
-On the gdb console, type "run" and press ENTER.
+```
+flatpak install flathub org.gnome.Boxes.Debug
+flatpak install flathub org.gnome.Platform.Debug
+```
+ * Open a shell session inside the Flatpak container with `flatpak --devel --command=bash run 
org.gnome.Boxes`
+ * Run Boxes with gdb with `gdb /app/bin/gnome-boxes`
 
-## 1.4 Reproduce the crash
+# Reproduce the crash
 
 Now Boxes should be opened, and you should proceed to perform the same action that caused your crash.
 
@@ -28,35 +26,26 @@ Once Boxes crashes, get back to the terminal with the gdb console and type:
 
 `bt all`
 
-## 1.5 Sharing your backtrace
+## Sharing your backtrace
 
 Copy everything printed on your terminal since you opened gdb, and paste in a text file. Attach your file to 
the GitLab issue where your crash is being reported.
 
-# 2. Flatpak
+# Activating debug messages
 
-## 2.1 Install the debug symbols
+To run Boxes with debug message output on the console, just run:
 
-```
-flatpak install flathub org.gnome.Boxes.Debug
-flatpak install flathub org.gnome.Platform.Debug
+```bash
+G_MESSAGES_DEBUG=Boxes gnome-boxes
 ```
 
-## 2.2 Open a shell inside the Flatpak container
+In Flatpak, run:
 
-`flatpak --devel --command=bash run org.gnome.Boxes`
-
-## 2.3 Run Boxes with gdb
-
-`gdb /app/bin/gnome-boxes`
-
-## 2.4 Reproduce the crash
-
-Now Boxes should be opened, and you should proceed to perform the same action that caused your crash.
-
-Once Boxes crashes, get back to the terminal with the gdb console and type:
-
-`bt all`
+```bash
+flatpak run --env=G_MESSAGES_DEBUG=Boxes org.gnome.Boxes
+```
 
-## 2.5 Sharing your backtrace
+In jhbuild, run:
 
-Copy everything printed on your terminal since you opened gdb, and paste in a text file. Attach your file to 
the GitLab issue where your crash is being reported.
+```bash
+G_MESSAGES_DEBUG=Boxes jhbuild run GNOME-boxes
+```
\ No newline at end of file


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]