Commit Diff


commit - fc616ab53971cedbf9cdd508798d7d511a96244d
commit + 96770ff69a849c9a9342f792f3243fe45e5ee3c5
blob - a8a2e083d197d3014267acdec4ab76defcdd514c
blob + 34d1b4f71bdcc825582cc84e568155d107cf54a4
--- pages/about_crash.gmi.in
+++ pages/about_crash.gmi.in
@@ -4,33 +4,29 @@ It seems that Telescope crashed last time!  Please con
 
 => mailto:@PACKAGE_BUGREPORT@	@PACKAGE_BUGREPORT@
 
-When reporting a bug, please include the following information, otherwise it won’t be helpful:
+When reporting a bug, please include the following information, otherwise it won’t be very helpful:
 
 * Operating system
 * Telescope version (i.e. @PACKAGE_STRING@)
 * how to reproduce the crash, if known
 
-If possible, a backtrace (the state of the program when it crashed) contains invaluable data to unveil the source of the bug.  Obtaining a backtrace is usually simple, but unfortunately depends on your system.
+If possible, a backtrace (the state of the program when it crashed) should be included too, as it contains invaluable data to understand the source of the bug.  Obtaining a backtrace is usually simple, but the exact procedure depends on the operating system.
 
-On most system, you should find a file named ‘telescope.core’ or ‘<number>.core’ or just ‘core’ in the directory where you launched telescope (probably your home).
+On most system, after a crash a file named ‘telescope.core’ or ‘<number>.core’ or just ‘core’ should appear in the directory where Telescope was launched (probably your home).
 
-Your shell may be configured to disallow coredumps.  If
+The shell may have to be configured to allow coredumps.  Running
 
-> $ ulimit -c
-
-prints 0 then you’ll need to enable coredumps using
-
 > $ ulimits -c unlimited
 
-and try to reproduce the bug again.
+should enable core dump for the current session on most shells.
 
-To open a core file you need to install ‘gdb’ (the GNU debugger) and type
+Once the core dump is located, a backtrace may be obtained with the aid of a debugger, like ‘gdb’ (the GNU debugger) or ‘lldb’ (the LLVM debugger):
 
 > $ gdb telescope path/to/core-file
 
-If you’re using a linux distro with systemd (Arch, Fedora, Debian, ...) you have to use coredumpctl to obtain a backtrace.  Please refer to the following page on the Arch wiki:
+On a linux distro with systemd (Arch, Fedora, Debian, ...) ‘coredumpctl’ may be needed to launch the debugger.  Please refer to the following Arch wiki page:
 
-> https://wiki.archlinux.org/title/Core_dump
+=> https://wiki.archlinux.org/title/Core_dump
 
 in particular the “Examining a core dump” section.
 
@@ -42,4 +38,4 @@ At this point you should be at the GDB prompt.  Just t
 
 To quit gdb, just type ‘q’ and enter.
 
-Thanks!
+Thank you!