2 Trying it Out

Contents of this section

2.1 Compiling rTc

  1. Unpack the compressed tar file. (left as an exercise to the reader)
  2. change directory to the top of the rTc distribution. (you should see subdirectories:- doc; include; libRws; libhtmlw; and src (along with some other files)).
  3. Edit include/rtc-config.h to reflect those options you want in the final binary, and the definitions of some rTc defaults, see Section Configuring rTc before Building for more details. You may need to modify the Imakefile to set the locations of header files and libraries.
  4. Type the following at a prompt.
    % xmkmf
    % make Makefiles
    % make depend
    % make
    

2.2 Running rTc

As a simple test of rTc, try running it with the example files, as shown below.

If WANT_SYSTEM was defined


% cd src
% ./rtc -f user-file --system-file system-file

If WANT_SYSTEM was not defined


% cd src
% ./rtc -f user-file-complete

Notes:-

  1. Using user-file on its own (with no accompanying system file) is not a good idea (it will probably crash, since it only adds to a menu structure that is expected to be already created).
  2. As these files test all the features, there may be some warning messages if support for a feature has not been compiled in, either:- ignore the message; remove the offending line; or recompile with the support added.

I personally start rTc from .xinitrc as the last client, making it the controlling client (meaning that when rTc terminates, my X session terminates).

2.3 Installing rTc

rTc does not need to be installed before it can can be used (see previous section), and you may need to be root to do this:-


% make install
% make install.man

The installation of the manual only installs the unformatted man page, the user guide and preformatted man page are not touched.

Next Chapter, Previous Chapter

Table of contents of this chapter, General table of contents

Top of the document, Beginning of this Chapter