[310,105]		Things
---------		------

This directory contains a number of useful programmes. Most are written
in C; the exception is hunt the wumpus, which is a fossil from the days
before the C compiler. 

All of these programmes are built in the same way. First compile all of
the source files for a programme using the commands:

			CCX file.c
			ASM -d file.s

Next build a task image using TKB. The simplest command is:
	>TKB xx[/CP]=xx,[1,1]C/LB
If for some reason your system does not allow the EXTK$ directive
the task will have to have additional memory allocated to it either
by EXTTSK=nnn at TKB time -or- by /INC=nnn at INS/RUN time. As
well a command name can be specified and LUNs assigned.

as8		8080 Assembler
---             ---- ---------

This programme is an assembler for the 8080. It reads source programmes
written in Intel mnemonics and PDP-11 style pseudo operations, and puts
out a listing file and an object file in Hewlett Packard ESC & b loader
format for the 2649 terminals.

Its options are:
		-l		Make a listing file
		-n		Don't make an object file

grep		UNIX grep (pattern search utility)
----		----------------------------------

This is an implementation of UNIX grep. It accepts the same patterns as
the editor.

Its options are:
		-c		Print count of matching lines
		-f		Print file names
		-n		Print line numbers
		-v		Do v/re/p rather than g/re/p

od		File dumper
--		---- ------

This programme is a  replacement for DMP.  It does most things that are
done by DMP, and does them in a more reasonable way; in particular, you
can dump in more than one format at once.

Its options are:
		-a		Dump ASCII characters
		-b		Dump octal bytes
		-f #		Set first block, default is 0
		-l #		Set last block, default is EOF
		-r		Dump by record
		-w		Dump octal words
		-x		Dump hexadecimal bytes
		-5		Dump radix 50 words.

If no dump selection options are present, od defaults to -w.

nm		Read namelist
--		---- --------

This programme reads through an object file or a TKB symbol table and
prints a list of all the symbols it finds. I have found that these are
a fine alternative to load maps, except for the fact that TKB does not
put the undefined symbols in the symbol table file.

It has dozens of options. They are:

	-1		Output names in 1 column, default is 4 column
	-b		Include RSX control block symbols. These are
			symbols of the form x.xxxx x$xxxx xx.xxx and
			xx$xxx. Normally these symbols are supressed.
	-c		Include C compiler internal symbols. These are
			symbols that begin with a "." and contain
			only digits. Normally supressed.
	-d		Differences. The symbol table is sorted by
			address, each symbol is replaced by the 
			difference between it and the next symbol.
			This is used to see how large your routines
			are.
	-f		Print symbols in file order. No sort is
			performed.
	-g		Print only global symbols. The default is
			to print globals and internals.
	-r		Reverse the direction of the sort.
	-u		Print undefined symbols. Undefined symbols
			are normally supressed.
	-v		Sort by value, the default is sort by name.

lc			List directory
--			---- ---------

This is a cross between UNIX ls and a programme written by C.H.Forsyth
on GECOS to list dairectories (a.k.a. catalogues). Normally files are
listed in alphabetical order, in 4 columns.

Its options are:
	-1			Print in 1 column format
	-d			Don't sort.
	-l			Print in long format
	-p			Include protection in -l format
	-t			Include totals in -l format
	-v			Include version numbers

l			List files page at a time.
-			---- ----- ---- -- - ----

This programme was written in 5 minutes because typing the command to
PIP to list a file on the terminal was too painful. Normally listing
stops after 20 lines; hit newline to get the next page or an end of
file to quit. The -n option supresses pagenation.

ttt			3-D tic tac toe
---			--- --- --- ---

This programme is a C version of a tiny basic programme that was in
Kilobaud a while back. It works, although there is a rumour that there
is an error in the move table.

wc			Word count
--			---- -----

This programme reads through a file counting up lines and words. If
more than one file is supplied the total number of words and lines
is printed.
