$Id: README,v 1.1 1995/05/10 09:23:02 richardo Exp $
rTc is Copyright (c) 1993,1994,1995 Richard M. Offer. rTc is covered
by the GNU Public License.
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 libhtmlw/HTML.c for its
license).
The GIF reading function used in the HTML browser is Copyright (c)
1990 - 1994, David Koblas. (koblas@netcom.com), see the file
src/gifread.c for its license.
Obtaining the Code
==================
The latest version of the source code can always be found via:-
The rTc home page. (http://www.robots.ox.ac.uk:5000/~vanye/rtc/).
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
(ftp://ftp.robots.ox.ac.uk/pub/linux/motif/rtc-2.0.tar.gz).
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
(file://ftp.x.org/contrib/applications/rtc-2.0.tar.gz).
Trying it Out
=============
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 the
documentation in doc/rtc.{txt,ps,html} for more details.
4. Type the following at a prompt.
___________________________________________________________________
% xmkmf
% make Makefiles
% make depend
% make
___________________________________________________________________
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
________________________________________________________________
