= MinGW Troubleshooting Q&A =

=== Q: My MSYS window is black / can't be resized to fullscreen ===

A: You're using the wrong shortcut to open MSYS. See the note at the bottom of [wiki:WindowsMinGW/current#MSYS the "MSYS" section in the installation guide].

=== Q: When I use "cm", I get "sh: cm: command not found" ===
{{{
$ cm
sh: cm: command not found
}}}

A: If you get this error, you have to define the "cm" alias as explained here: [wiki:WindowsMinGW/current#BuildOrxonox].

=== Q: When I use "cm", I get a different error ===

There are multiple errors with multiple reasons. Sometimes this can be solved by closing (all instances of) MSYS and/or rebooting Windows.

Note that if you're using a sane installation of MinGW and the other tools (as explained in [wiki:WindowsMinGW/current the guide]), you should be able to use {{{cmake}}}, {{{gcc}}}, and {{{g++}}}. You can check this in the MSYS console:
{{{
$ cmake --version
cmake version 2.8.2

$ gcc --version
gcc.exe (GCC) 4.5.0

$ g++ --version
g++.exe (GCC) 4.5.0
}}}
The actual output and versions may differ, but you shouldn't get any errors. If one of the three tools can't be found, refer to the according question ("xxx": command not found).

If all three tools seem to work, but you still get an error using "cm", refer to the questions below ("CMake complains about xxx").

=== Q: "cmake": command not found ===
{{{
$ cmake --version
sh: cmake: command not found
}}}

A: CMake is not installed properly or it is not added to the environment variable PATH. Please refer to [wiki:WindowsMinGW/current#CMake the guide] for an explanation.

=== Q: "gcc": command not found ===
{{{
$ gcc --version
sh: gcc: command not found
}}}

A: Make sure you installed MinGW and MSYS properly by following [wiki:WindowsMinGW/current the guide]. You can also open the file {{{c:\<msys-install-path>\etc\fstab}}} with a text-editor (WordPad, Notepad) and check if the path to MinGW is configured correctly (default is {{{c:/mingw /mingw}}}).

=== Q: "g++": command not found ===
{{{
$ g++ --version
sh: g++: command not found
}}}

A: You probably missed to install g++ with MinGW. Please refer to [wiki:WindowsMinGW/current#MinGW the installation guide] and ensure you selected "C++ Compiler" in the installation menu of MinGW.

=== Q: CMake complains about a missing dependency directory ===

A: You probably get an error like this:
{{{
$ cm
[...]
-- *** Build type is Debug ***
-- Warning: Could not find dependency directory.Disable LIBRARY_USE_PACKAGE if you have none intalled.
[...]
}}}
In this case you didn't put the dependency package into the right directory. Please refer to [wiki:WindowsMinGW/current#Dependencies the guide] for more information about the dependency package and where to place it. Also make sure that you don't use two nested dependency directories (i.e. {{{/home/username/dependencies/dependencies}}}) but just one.

=== Q: When I run Orxonox and start a level, it crashes. ===

A: Check if you get an error similar to this:
{{{
terminate called after throwing an instance of 'Ogre::ItemIdentityException'

what():  OGRE EXCEPTION(5:ItemIdentityException): Unable to derive resource gr
oup for templates/includes/weaponsettings3.oxi automatically since the resource
was not found. in ResourceGroupManager::findGroupContainingResource at ../../Ogr
eMain/src/OgreResourceGroupManager.cpp (line 1782)
}}}
In this case you probably compiled Orxonox with a different version of MinGW than the dependencies are. Note that there are two different methods of exception handling: SJLJ (setjmp/longjmp) and DW2 (Dwarf-2). The dependencies are compiled using DW2. You either have to recompile the C++ dependencies (boost, cegui, ogre) or install the correct version of MinGW. You can check which method your installation supports if you search for {{{c:\mingw\bin\libgcc_s_xxx-1.dll}}} - xxx is either dw2 or sjlj.