next up previous contents index
Next: 1.5 Questions and Comments Up: 1 Introduction Previous: 1.3 How to Obtain


1.4 TCM and the Unix Environment


1.4.1 Getting Started

  TCM runs on Unix systems with X Windows version 11 release 5 or higher and uses the Motif library release 1.2 or higher for the graphical user interface. For up-to-date system requirements see the file README.TCM in the software distribution.

When you have retrieved the TCM distribution in the form of a Unix tar file compressed with the gzip program [*], you have to install [*] it in a new directory, preferably /usr/local/tcm [*]. Each user should set the environment variable TCM_HOME to the directory where TCM resides, and add $TCM_HOME/bin to the PATH shell variable and add $TCM_HOME/man to the MANPATH shell variable. TCM will not work when TCM_HOME is not set. Do not forget to export these variables. You can start a particular tool in two ways:

Figure 1.2: The TCM startup window.

\includegraphics [height=5in]{p/}\end{center}\end{figure}


Call it from the program tcm. tcm displays a window containing a push button for each available editor (see figure 1.2). To start an editor click the corresponding button. The diagram and tree editors are started up immediately. When a table editor is chosen, first a dialog is displayed in which you can change some options. Be careful, because each time you click a button a new editor is started. To kill the tcm startup program issue Quit from the File menu. The processes of the running editors are independent from the running startup program, so when you quit a startup program, all other programs continue to run.

Call the editor directly from the shell, e.g. terd, tdfd, tcrd. Perhaps you want to end the command with an ampersand to run it in the background. You can supply a single document name as command line argument. If this argument is the name of an existing file then the editor tries to load a document from it. If the document does not exist, a new document is created in the editor having the argument as document name. In section 1.4.2 we give an overview of the flags that can be given in the command line and the Unix environment variables that are used by TCM.

1.4.2 Unix options, files and variables


The Unix manual pages in the TCM distribution give an up-to-date overview of all arguments, environment variables and files that are used by TCM. Here we will give some explanation of the most important ones. TCM has the following command line arguments:

Table editors additionally have the following optional command line arguments:

In addition to the TCM tool executables themselves and shared libraries, the tools depend on the following files:

The TCM editors depend on the following Unix environment variables.  

1.4.3 Graphical User Interface


The user interface of TCM complies for a large part with the OSF/Motif Style Guide [11]. The user interface is built from the OSF/Motif widget set [10]. The result is that user interaction through menus, dialogs, buttons, scroll bars and text areas work in the same way as other Motif applications and environments such as for instance Netscape for X Windows and CDE (common desktop environment). Only the drawing of diagrams and tables itself is quite different and this part does not make use of Motif. In any case, the TCM editors should be well-behaved under all popular X Window managers, e.g. fvwm, mwm, olwm, vtwm, twm. In [12] you find the specification of the user interaction with Motif applications in general, so it is not necessary to repeat that in this manual.

TCM looks optimal on a full color display and a resolution of at least an XVGA screen (1024x756). It should still be usable though on a black and white display and/or an SVGA screen (800x600). For more detailed information about the other system requirements of TCM regarding Motif, X Windows and Unix see appendix A.

next up previous contents index
Next: 1.5 Questions and Comments Up: 1 Introduction Previous: 1.3 How to Obtain
Frank Dehne,Faculty of Mathematics and Computer Science, Vrije Universiteit Amsterdam