=== Introduction ===

rshx(1) is an extended form of BSD rsh(1).  It was written as a companion
to DDT, a directed differential testing system for C and C++ compilers.
For details about rshx(1), see the comments at the beginning of the
script.  You will probably need to tailor the script in small ways to fit
your site.

The scripts named after platforms are symbolic links to a common script.
That script picks a host based on the platform name, and then invokes
rshx(1) on that host, passing the specified command.  Consult the script
"on-platform" for further details, also the script "rshx-make-links".  You
will need to tailor those two scripts to fit your site.

When used with DDT to test remote compilers, each of the entries in DDT's
hosts list (cf. "hosts.ddt") should correspond to one of the platform
names understood by those two scripts.  Having done that, you can test a
remote compiler by specifying the appropriate platform name as the first
word of an entry in your compiler list (cf. "compilers.ddt").  For further
information, consult the sample provided with the DDT kit, in the
directory "samples/testing-remote-compilers/".


=== Installation ===

To install rshx, tailor the scripts "rshx", "on-platform", and
"rshx-make-links" as appropriate, and then copy them to a directory that
appears in your execution search path (cf. $PATH or %PATH%).  Next execute
rshx-make-links in that directory to create links to "on-platform" that
are named after specific platforms of interest.  Finally, if you are using
rshx with DDT, update your DDT compiler and host lists as appropriate.


=== Further Information ===

For further information, please consult the DDT README file.  Among other
things, the DDT README file discusses the DDT mailing lists, how to report
bugs, and how to contact the core DDT development team.