As a first start you can compile and run some of the example programs that come with Tscope.
They can be found in C:\cygwin\usr\local\tscope\examples
.
Compiling a program from within the editor is simple: open your source
file, and press F9. The editor will invoke the scripts necessary to compile your program. The
output of the compilation process shows up in the lower part of the screen (output window).
This output will also contain error messages from the compiler. If you don't have Tscope
installed yet, only standard C programs can be compiled and the shortcut to do that is CTRL-F9.
Once you have resolved all the errors the compiler complains about, you can start
running your program. F10 will run your program. Text output will be shown in a DOS box. To
abort your program when it hangs, <ALT>-<TAB> to the DOS box and press
<CTRL>-<C>. The contents of the DOS box can be copied to the clipboard by pressing
<ENTER> in the DOS box.
Before you compile your program, it's a good thing to clean up your code
a bit to increase readability. This can be done automatically with the indent program. It
inserts or removes whitespace so that your program complies to a specific coding style.
Pressing F8 will apply the indent program to your source file. Dependent on the speed of your
system, Crimson editor will tell you that your source file has changed, and ask whether you
want to reload it (yes you want to). If Crimson editor does not notice the change, you should
manually reload your source file by pressing the Reload document item in the document menu. The
indent program will make a backup copy of your file. It will have the same name as your source
file, with a
~
appended to it.
Backup copies of your source file made by the indent program
can be removed by pressing F11. This command will also remove your executeable - there is no
point in keeping these after use as they need to be recompiled every time an update of Tscope
is installed.
New versions of Tscope become available from time to time. Most changes will be
only minor (bugfixes, extra features, extra documentation or examples, ...). It is a good idea
to always have the latest version of Tscope installed, as it will have the least bugs, most
features, etc. Especially if you think you found a bug in Tscope you should install the latest
version before reporting the bug. Chances are that somebody else already reported the bug and
that it has been removed in the latest version.
The F12 shortcut will check whether a new version is available and install it automatically
if necessary.