----------------
        Here is a yacc toy, a hexadecimal calculator program. It's based on
        hoc3 for those familiar with chapter 8 in _The Unix Programming
        Environment_ by Kernighan and Pike. To use it, run it and type help.
        Or better yet, read the included man pages.

	This package is being distributed in both .ARC archive and shell
	archive (shar) form and is made up of the following files:

		1st_read.me		this file

		hexcalc.exe		executable (.ARC only)

		hexcalc.h		c source code
		ytab.h
		bltins.c
		symbol.c
		ulpow.c
		yylex.c
		init.c
		ytab.c

		hexcalc.y		yacc source code

		makefile.dos		miscellaneous files
		makefile.unx
		hexcalc.man
		hctest01.txt
		hctest02.txt

	Included are two simple test "programs" that when fed to hexcalc via
	stdin exercise expression evaluation and commands. See the test
	dependency in the Unix makefile.

        I have included the yacc generated source and header files for those
        who are developing in a non-Unix environment and don't have
        immediate access to yacc(1). For the MS-DOS environment, I use the
        version of yacc distributed with the MKS Toolkit. That was the
        version used to generate the yacc output files.

	The MS-DOS makefile requires the presence of the MKS Toolkit and
	Turbo C to be useable. The mv, rm, and tcc command invocations can 
	be modified as appropriate, but it still requires yacc to generate 
	new ytab.h and ytab.c files. However, the use of make is not required 
	to generate the executable. The tcc invocation line

	tcc -ehexcalc.exe  ytab.c init.c symbol.c bltins.c yylex.c ulpow.c

	should do it.

        Needless to say, Unix is a trademark of AT&T, MKS Toolkit is a
	trademark of Mortice Kern Systems, Turbo C is a trademark of
	Borland International, and MS-DOS is a trademark of Microsoft.

        Richard Hargrove, 25 June 1988
	...!{ihnp4 | codas | cbosgd}!killer!richardh
	--------------------------------------------