This directory contains TECO-C,  a version of TECO written in C.
It was written in C so the author could move comfortably from VAX/VMS
to various other machines,  including MicroVaxes,  which cannot execute
TECO-11 because they don't support PDP-11 compatibility mode.

	If you find bugs or have any comments about TECO-C,  please contact

			Pete Siemsen
			645 Ohio Avenue #302
			Long Beach, Ca. 90814

			(213)-433-3059

	TECO-C is meant to be a complete implementation of TECO as defined by
the PDP-11 TECO User's Guide (DEC Order Number DEC-11-UTECA-B-D).  There is
no manual for TECO-C;  the TECO-11 manual should be used.  It can be ordered
from DEC.  Although there is no TECO-C manual,  there is a list of commands
in file "commands.txt".

	TECOC runs under VAX/VMS and almost runs under XENIX.  The XENIX
code is part of an ongoing effort to make TECO-C portable.  It is close,  but
not yet completely portable.

	To run TECO-C under VAX/VMS,  modify file VSYMBS.COM to make the
file specifications correct and then execute the file.

	TECO-C uses a UNIX-link command line.  The qualifiers are -c (create),
-d (mung data), -m (memory), -p (mung), -r (readonly).  Although this is
different than TECO-11,  you can still execute the usual way by saying
"TECOC filename".

	A comparison of TECO-C and TECO-11 can be found in file FALL87.RNO,
which contains notes for a DECUS symposium session describing TECO-C.
Other differences are listed in file PROBLEMS.TXT.

	TECO-C compiles without error on the VAX using the VAX-11 C compiler
v2.3 under VMS v4.5.  The TECOC.EXE image in the saveset was compiled/linked
under VMS 4.3.  It also compiles under XENIX v2.3A.  Before compiling,  the
ZPort.h file must be edited to define the system for which the code is being
compiled.



	The files are as follows:

	*TST*.TEC files are macros used to test TECOC.

	*.TEC (except *TST*.TEC) are various macros.  The only important one
		is CHANGE.TEC,  described below.

	AMODEM.C is a rudimentary modem-transfer program for XENIX.
		I wrote it to transfer TECOC from a VAX to XENIX.  After
		running it,  I run XAFTER.CSH to clean up the results.

	CHANGE.TEC is a macro to change strings in files.  This macro works
		like the VMS "SEARCH" command or the UNIX "grep" command,
		but it changes the search string to another string.

	COMMANDS.TXT contains a wall chart of TECO commands.

	DELDBG.TEC makes TECO-C programs readable by deleting the
		in-line debugging code.  The files it produces should
		be printed and deleted;  modifications should be made to
		the source code.  Unfortunately,  it's a TECO macro,  so
		it won't help you if you don't have TECO already running.

	DEFTECO.H defines structures,  general identifers, and describes the
		debugging scheme.

	FALL87.RNO contains session notes for the Fall 87 DECUS session
		about TECO-C.  This file is interesting because it contains
		a summary of the differences between TECO-11 and TECOC-C.

	PG.MEM is a programmer's guide.  It is generated by passing PG.RNO
		through RUNOFF under VAX/VMS.  It may be useful to anyone
		fixing bugs,  adding features,  or porting TECO-C to a new
		environment.

	PG.RNO is the source of PG.MEM.  Use VAX/VMS RUNOFF to make PG.MEM

	PROBLEMS.TXT contains notes about bugs and ideas.

	RELEASE.TXT contains release notes starting from version 1.0 (100)

	TECOC.C is the main source module,  and contains all the definitions
		of system-independent global variables,  as well as some
		comments explaining what they are.

	TECOC.RNH contains more help than TECO-11 had.  Use RUNOFF to make
		a .HLP file and LIBRARY to make the library.  It is not
		complete,  but it's much better that what comes with TECO-11.

	ZVBLD.COM compiles and "library"s the main-stream (not debug) code
		under VAX/VMS.

	ZVDBLD.COM compiles and "library"s the debug code under VAX/VMS.

	XAFTER.CSH is used under XENIX to clean trash from files that have
		just been created by AMODEM.

	ZXBLD.CSH compiles and "library"s the main-stream (not debug) code
		under XENIX.

	ZXDBLD.CSH compiles and "library"s the debug code under XENIX.

	ZINIT.C contains declarations of all the system-dependent variables.

	ZVCCC.COM (under VAX/VMS) and ZXCCC.CSH (under XENIX)
		compile and "library" a single module.

	ZVLOGIN.COM (under VAX/VMS) or ZXLOGIN.CSH (under XENIX)
		should be done at login time to use or develop TECOC


	The W command does not work,  but the EXEW.C file contains code
to tell you what the command would have done if it had been executed.
I used this to play with executing VTEDIT.TEC under TECOC in order to find bugs.

	I am compiling a library of TECO stuff.  So far,  I have scanned the
RSX SIG tapes and the VAX SIG tapes from DECUS symposia.  I've gotten the
source code to another TECO written in C that runs under ULTRIX and on SUNs.
I hope to soon have a copy of a TECO that runs on IBM PCs.  I will soon have
all the TECO-related elements of the DECUS Software Library.  I will soon have
TECO stuff related to RSTS in VAX-readable form.  I plan to organize all this
stuff and submit the results as a single enity to the DECUS Software Library.

	I you have something that you feel should be included in this
collection,  please contact me.