X-Git-Url: http://de.git.xonotic.org/?p=xonotic%2Fxonotic.wiki.git;a=blobdiff_plain;f=Programming-Tips.md;h=afef0e7411c3b3f1c698a31e2f85e3431b6efd6d;hp=6bb78baf4490c4e87f9c683c4ee2f3411dd8e5a6;hb=71b69e13a0b5458ffb0184250b7984e58d85929f;hpb=89d58a9e919087f9d369974e65e33630401af86f diff --git a/Programming-Tips.md b/Programming-Tips.md index 6bb78ba..afef0e7 100644 --- a/Programming-Tips.md +++ b/Programming-Tips.md @@ -53,3 +53,21 @@ prvm_breakpoint server prvm_globalwatchpoint server prvm_edictwatchpoint server ``` + +### Tool to find C symbols, functions, declarations and definitions inside source code + +For this purpose it's possible to use a text-based tool called [Cscope](https://en.wikipedia.org/wiki/Cscope) together with a GUI (it can be either an application or a plugin for a text editor). + +#### Download / Installation + +* Download and install cscope with `pacman -S cscope` +Windows users must download the Windows version of cscope from https://code.google.com/archive/p/cscope-win32/downloads since the mingw version generates broken indices and put it into the main xonotic repo directory. + +* Download and install a cscope GUI or a plugin for your text editor / IDE. For example for jEdit there is a plugin called [CscopeFinder](http://plugins.jedit.org/plugins/?CscopeFinder). + +* Copy [cscope_createindex.sh](uploads/17c725e19be8f4935c30c2506e168405/cscope_createindex.sh) into the main xonotic repo directory. + +#### Usage + +* Run `cscope_createindex.sh` to build cscope indices for both game (QC code) and Darkplaces (C code). This step must be repeated every time you do some code changes. +The indices can now be used to browse code confortably with the cscope GUI of your choice. \ No newline at end of file