This is the User Guide for rTc, a Motif-based program launcher (don"t be scared, the program does"t (really) need a manual anywhere near as big as this to use it, but the instructions on configuring the various optional features before compiling it are quite big).
The documentation has been written using a hacked Linuxdoc-SGML DTD, but I"ve supplied versions in preformatted in PostScript, HTML and plain ASCII. The Linuxdoc-SGML package has the advantage of being able to produce HTML (for on-line help), LaTeX (hense PostScript for nice-looking printed docs); and nroff/ascii output (for man pages) from a single input file.
rTc is a simple to use, but fully functional program launcher utility for Unix workstations running X/Motif. As well as the usual feature of executing commands, it also allows the user to :- customize the command before it is executed (ie. allowing the user to specify a printer); limit the number of invocations of a particular command (ie. only allowing the user to start one instance of a word processor); a help display system (including optional HTML support); a clock (with reminder facility); and mailbox and disk-space watchers ("how many messages do I have ?" and "how much space is there ?") .
Since rTc is a simple X client it can be used with any window
manager, in fact if you link it with
IXI"s Wintif(TM) library (blatant advertising :-)
) it
will even look and feel like a Windows 3.1 program!
This program is free software, you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version. This program is distributed in the hope that it will be useful,but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details. You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
The HTML browser widget is Copyright (c) 1993, Board of Trustees
of the University of Illinois (see the file
The GIF reading function used in the HTML browser is Copyright (c)
1990 - 1994, David Koblas. (koblas@netcom.com
), see the file
This release is in response to the extended beta test I had for version 2.0, a few bug-fixes (mainly on platforms I hadn"t tested on) and the re-introduction of audio feedback. The rest of this document assumes I am talking about version 2.0.
The raison d"être for this new, improved version of rTc has been to increase configurability, both at compile time (if you don"t want a feature you shouldn"t need to compile it in) and run-time. This has been achieved by re-writing the program to be be more modular (I would say object-orientated, but I don"t know what it means). There are no interdependencies between different options, so any may be left out, and it is easy to add new ones without having to worry about combatability with existing code.
Run-time configurability has been increased so that the user can specify:- the style of the program (do error messages use dialogs or a status line); the type of messages displayed (only Errors, Errors+Warnings, Errors+Warnings+Output); the type of user (expert or beginner, beginner mode has a simpler interface). There is a also the facility to specify two description files, a system and a personal one. The personal one may add entries to the menus specified in the system file, but not remove them.
A list of some the features of rTc are :-
There has, unfortunetly, been a few incompatible changes in the
description syntax between versions 1.3 and 2.0. I have provided a
small awk script to convert version 1.3 files to the new syntax
(
To use the
% awk -f update.awk input
Where input is the old (v1.3) rTc description file. The new file is written to stdout.
While the awk script corrects the syntax, the options (particularly the time options) may need to be modified by hand to get identical results.
The latest version of the source code can always be found via:-
This is the master site, (which also includes this guide in HTML format on-line).
For those without WWW access the source may be accessed directly at :-
The Oxford University Robotics Research Groups FTP server .
Please note this machine is remarkably unreliable, and I can no longer just walk over to it and kick it (its about 100miles away), so the WWW page is preferable.
Due to these sites belonging to an ex-employer I am currently investigating other alternatives, but both of these should be okay at least until the end of the year.
For the vast majority of you (and as a means of getting it mirrored at other sites), I"ve also put it on The X Consortium FTP Server .
This version was originally intended to ship before Christmas, then I delayed it until after Christmas, now easter is leaving us fast. I"m sorry, I"ve had a lot on recently (moved jobs, moved cities, moved house, oh and of course the usual family and personal problems). One of the advantages of my new job is the increase in the number of architectures I have access to: I still have access to Linux and SGI Irix 5.2, but now SunOs, Solaris, HPUX and AIX have been added (AIX hasn"t been tested yet).
I had intended to write some new features specific to X11R6 in this
version, unfortunetly I am still having some problems with Motif 2.0
under X11R6 on Linux (my main development environment). I have managed
to compile and test rTc under X11R6/Motif 2.0, but my Motif
2.0 setup is not yet stable enough to use it as the base for
development (if you"re interested---the file selection box
doesn"t work at all, and XmGetPixmap
appears to go into an
infinite loop).
As I had slipped so far and still have no idea how long it will be before I managed to get X11R6 and Motif 2.0 working happily together, I"ve bit the bullet and decided to ship what I"ve got now.
I hope to include some Motif 2.0 specifics (ie. spin-box, combo-box, container, and notebook widgets in panels), however if you would rather see R6 specifics (ie. session management---not much use until there are session aware clients) in the next version (2.1) then if you let me know, I can see what the relative response is.
However I don"t expect another release for a while as I"d like to put off active development (ie. I"ll only be bug fixing) to give me some time to write another program, change-is-as-good-as-a-rest and all that.
I"d like to thank all those who have contacted me with ideas/requests for enhancements/or bug reports, especially Mark Davis (mark@taylor.infi.net) who had lots of ideas and infinite patience while we tried to port it to SCO ODT.
I could"t put every request into this version, maybe next time...
Next Chapter, Previous Chapter
Table of contents of this chapter, General table of contents
Top of the document, Beginning of this Chapter