/******************************************************************************/
Spring, 1982 RSX SIG Tape Submission
UIC [374,2] (Goes together with [374,1]. See [374,1]README.1ST)
By:
Bob Denny
Creative System Designs


SOFTWARE TOOLS

This UIC contains source for a number of programs that are generally
useful. There's a lot more C stuff on the full Kit, this is a
sampler (the most immediately useful). Invoke MTOOL.CMD to build
the whole lot. It's a fine test of the compiler, assembler and library.
The XRF program is a reasonable example for learning the fine points
of C. It is the first program I (RBD) wrote in C, so don't laugh too
hard. All tools contain embedded command file generator macros and
documentation. See the documentation on BUILD and GETRNO. After
building the tools, try invoking MGTDOC.CMD in this UIC.

The programs are:

comm Compare the contents of two files, indicating what is common
to both files, and what is different. comm ? gives help.

diff Differential file comparison program, as described in Bell Labs
C.S. technical report 41.

echo Echo arguments -- used mostly to debug the compiler and
run-time system.

grep "Global Regular Expression Pattern" -- search files for
lines which satisfy an argument pattern. grep ? gives help.

kwik Kwik index program. Link with sorts.c.

l List on a screen terminal (you hit return every 23 lines).

mc A multi-column print utility.

mp A full macro processor for C source files, written by R.W.
Harper of Rensalear Institute of Technology and originally
distributed on a Unix SIG tape. It has been modified to
interface with the Decus compiler; it generates the predefined
#define's and otherwise interfaces just fine now. It supports
the full functionality as described in Kernighan and Ritchie.

nm Print "namelist" -- prints global symbols for an object module.
Lots of options described in the source code, but nowhere else.
Does global cross ref's faster then TKB.

od Octal dump of a file -- Options described in the source code only.
As the RSX library doesn't mangle file attributes, some of the
features don't work. od dumps records on RSX, blocks on RT11

pr Print with line numbers.

sortc Sort a file. Help in sort.rno/sort.doc

sorts Sort library routines. Help in the source code. Used by kwik.

t File type (on a video screen) utility. Run T and see. Works
well on a network virtual terminal. Handles random RMS file
formats.

today Print today's date in readable English. Uses the following
subroutines: (check this out!! (RBD))

datetx Convert date to English
moontx Convert phase of the moon to English
nbrtxt Convert an integer to English
timetx Convert time of day to English

Very good program, if I do say so myself(MM).

uniq Print unique lines from a file, uniq ? gives help.

wc Word/line/byte counter

xrf Cross reference listing for C programs. An excellent tutorial
introduction to the C language (if I do say so myself (RBD)).

/******************************************************************************/
/******************************************************************************/