You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Debug.md
+33-21Lines changed: 33 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,35 +2,47 @@ To submit a bug report that concerns a crash to the Red Eclipse Team, it is help
2
2
3
3
## Windows (64 bit)
4
4
5
-
You must download and install Code::Blocks for easiest building on Windows.
5
+
You must download and install MSYS2 for easiest building on Windows.
6
6
7
-
### Setting up Code::Blocks
7
+
### Setting up MSYS2
8
8
9
-
- Install TDM-GCC-64
10
-
- You may need to set the Code::Blocks compiler to TDM-GCC-64, open Code::Blocks and go to `Settings -> Compiler -> Global Compiler Settings -> Toolchain Executables`. Paths may need changed depending on where you installed it.
- Install MSYS2 from https://www.msys2.org/ and follow the instructions on that page
10
+
- Then launch **MSYS2 MinGW x64** from the start menu
13
11
14
12
### Compiling Red Eclipse
15
13
16
-
- Open redeclipse.cbp in Code::Blocks as a project.
17
-
- Select the debug build (redeclipse-amd64-dbg)
14
+
In the MSYS2 prompt, change directory to the location that of Red Eclipse:
15
+
```
16
+
cd /c/Users/qreev/Documents/redeclipse
17
+
```
18
+
*(note: that MSYS2 is using "/" as the root directory, so that `C:\Users\qreev\Documents\redeclipse` would be written as `/c/Users/qreev/Documents/redeclipse`*
19
+
20
+
First you must compile with debug symbols:
21
+
```
22
+
make -Csrc clean && CXXFLAGS=-ggdb3 make -Csrc install
- Red Eclipse will now start, attempt to crash it.
30
-
- Once crashed, you will see the debugger near the bottom of the screen with a Command input. Write `bt full` in that command input and press enter.
40
+
Now attempt to reproduce the problem in game. Once Red Eclipse has crashed, GDB will catch this and present a prompt. At this prompt run:
41
+
```
42
+
bt full
43
+
```
44
+
This will produce a backtrace, copy and paste this to an accessible place such as a crash report on the Red Eclipse [Github Issues page](https://github.com/redeclipse/base/issues) or paste to the Red Eclipse [Discord](https://discord.com/invite/RPDmG5Z).
- This will produce a backtrace, copy and paste this to an accessible place such as a crash report on the Red Eclipse forum or a paste service to be linked on [IRC](IRC.md).
34
46
35
47
## Linux
36
48
@@ -46,12 +58,12 @@ Then run with GDB:
46
58
```
47
59
gdb src/redeclipse_linux
48
60
```
49
-
Inside GDB, to start Red Eclipse:
61
+
Inside GDB, to start Red Eclipse, type:
50
62
```
51
63
run
52
64
```
53
-
Once Red Eclipse has crashed, GDB will catch this and present a prompt. At this prompt run:
65
+
Now attempt to reproduce the problem in game. Once Red Eclipse has crashed, GDB will catch this and present a prompt. At this prompt run:
54
66
```
55
67
bt full
56
68
```
57
-
This will produce a backtrace, copy and paste this to an accessible place such as a crash report on the Red Eclipse forum or a paste service to be linked on [IRC](IRC.md).
69
+
This will produce a backtrace, copy and paste this to an accessible place such as a crash report on the Red Eclipse [Github Issues page](https://github.com/redeclipse/base/issues) or paste to the Red Eclipse [Discord](https://discord.com/invite/RPDmG5Z).
0 commit comments