= Using KDevelop as your IDE =
== Necessary steps ==
If you want to code comfortable then we suggest you to use an IDE. The below steps describe how to use KDevelop as your IDE.
 1.a) Go to the orxonox build directory:
{{{
cd ~/orxonox/trunk/build
}}}
 1.b) Make sure you didn't run cmake before in this directory. If you did, just remove the CMakeCache file (note: you will have to rebuild the project afterwards, if you do this)
{{{
rm -f CMakeCache.txt
}}}
 2. Let cmake produce the basic KDevelop project file:
{{{
cmake -GKDevelop3 ..
}}}
 3. Run KDevelop and open your project file (Project -> Open Project)
'''Edit essential options'''
 4. Go to ''Project->Project Options'' choose ''Run Options'' and change following things:
  || Executable || #PATH_TO_ORXONOX/build/bin/orxonox ||
|| Working Directory || #PATH_TO_ORXONOX/build/bin ||
 5. Now choose ''Build Options'', select ''Make'', activate ''Run multiple jobs'' and change ''Simultaneous jobs'' (e.g. to 4)
== Make KDevelop more efficient ==
In order to improve productivity you can activate / benefit from some features.
=== Shortcuts ===
 * F8: Build the Project
 * F9: Start the debugger (gdb based)
 * If you want to define further shortcuts (i.e. ''Run Application'') then you can configure them in ''Settings -> Configure Shortcuts''
=== Code Completion ===
If you want to use code completion do the following steps:
 1. Go to ''Project Options'' and select ''C++ Support''.
 2. Enable ''Automatic Code Completion'' and set the preferred options.
=== Split of Header/Source files ===
If you want to benefit from the following feature then follow the below steps.
[[br]][[br]]
[[Image(wiki:KDevelop3:split.png, 100%)]]
 1. Go to ''Project Options'' and choose ''C++ Support''.
 2. Select ''Navigation'', enable ''Enable split of Header/Source files'' and change Orientation to Horizontal (if you want to)
 3. Choose ''File Groups'' and change ''Sources'' to "*.cc;*.cpp;*.c;*.C;*.cxx" (append *.cc)
 4. Open a Source file and press ''Shift + F12" (or alternatively just open the Header file and hope it works ;))