1 8064b849 2021-07-20 op # Oops
 2 8064b849 2021-07-20 op 
 3 8064b849 2021-07-20 op It seems that Telescope crashed last time!  Please consider reporting this bug so it can be fixed.
 4 8064b849 2021-07-20 op 
 5 8064b849 2021-07-20 op => mailto:@PACKAGE_BUGREPORT@	@PACKAGE_BUGREPORT@
 6 8064b849 2021-07-20 op 
 7 89995f23 2021-08-16 op When reporting a bug, please include the following information, otherwise it won’t be helpful:
 8 8064b849 2021-07-20 op 
 9 8064b849 2021-07-20 op * Operating system
10 8064b849 2021-07-20 op * Telescope version (i.e. @PACKAGE_STRING@)
11 8064b849 2021-07-20 op * how to reproduce the crash, if known
12 8064b849 2021-07-20 op 
13 89995f23 2021-08-16 op 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.
14 8064b849 2021-07-20 op 
15 8064b849 2021-07-20 op 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).
16 8064b849 2021-07-20 op 
17 8064b849 2021-07-20 op Your shell may be configured to disallow coredumps.  If
18 8064b849 2021-07-20 op 
19 8064b849 2021-07-20 op > $ ulimit -c
20 8064b849 2021-07-20 op 
21 8064b849 2021-07-20 op prints 0 then you’ll need to enable coredumps using
22 8064b849 2021-07-20 op 
23 8064b849 2021-07-20 op > $ ulimits -c unlimited
24 8064b849 2021-07-20 op 
25 8064b849 2021-07-20 op and try to reproduce the bug again.
26 8064b849 2021-07-20 op 
27 8064b849 2021-07-20 op To open a core file you need to install ‘gdb’ (the GNU debugger) and type
28 8064b849 2021-07-20 op 
29 8064b849 2021-07-20 op > $ gdb telescope path/to/core-file
30 8064b849 2021-07-20 op 
31 8064b849 2021-07-20 op 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:
32 8064b849 2021-07-20 op 
33 8064b849 2021-07-20 op > https://wiki.archlinux.org/title/Core_dump
34 8064b849 2021-07-20 op 
35 8064b849 2021-07-20 op in particular the “Examining a core dump” section.
36 8064b849 2021-07-20 op 
37 8064b849 2021-07-20 op At this point you should be at the GDB prompt.  Just type ‘bt’, press enter and copy all the output in a mail to @PACKAGE_BUGREPORT@.
38 8064b849 2021-07-20 op 
39 8064b849 2021-07-20 op > (gdb) bt
40 89995f23 2021-08-16 op > ...lots of useful information...
41 8064b849 2021-07-20 op > (gdb)
42 8064b849 2021-07-20 op 
43 8064b849 2021-07-20 op To quit gdb, just type ‘q’ and enter.
44 8064b849 2021-07-20 op 
45 8064b849 2021-07-20 op Thanks!