TeXTools	Version	1.0
Date:		2/24/87
Modified 8/3/87 for Stanford Earth Sciences by Phil Farrell

Copyright (C) 1987  by Kamal Al-Yahya

This directory contains some filters that were developed at the
Stanford Exploration Project (SEP), Geophysics Department, by Kamal Al-Yahya.
Copying them to any other machine is permitted without prior permission
provided that copyright messages are kept, no profit is made by copying
the files, and modifications are clearly documented.

Acknowledgment:
Many users both in and outside the SEP gave valuable feedbacks that
profoundly improved the programs. I am grateful to all of them.

The main programs have names that end with either 1 or 2 (e.g. detex1.c,
detex2.c). Those ending with 1 are used in makefile.nopar and are for those
sites that do not have getpar(). The plain makefile expects to have getpar
in libloc and uses the programs with the suffix 2, in order to allow
in=  and out=  for input and output file specification.
Also, there is a makefile.msc to be used with MSC-DOS.

The maximum number of characters in a document is set by MAXLEN
(in setups.h) to be 65535. If the limit of unsigned integers in
your machine is lower than this, change this number accordingly.

To install:
 - modify MAXLEN in setups.h if necessary.
 - choose either makefile, makefile.nopar, or makefile.msc (as explained above).
 - add -D flags to CFLAGS (e.g. -Dtops20, -DMSC, -DNO_SGTTY, -DANSI)
 - type 'make'.
 - test the programs on the testfile provided.
 - type 'make install' to move the executables to the directory specified in 
	BIN macro definition in makefile (like /usr/local/bin).
 - type 'make clean'.

The following files should be in this directory:

README		this file
setups.h	an include file used by all programs.
testfile	a file that demonstrates how these programs work
inc_file	an include file that is opened by testfile
inc_file2.tex	another include file
makefile	normal makefile for Stanford Earth Sciences
makefile.nopar	a makefile for those who do not have access to getpar()
makefile.msc	a makefile for MS-DOS systems
detex1.c	strips TeX's commands from the document
detex2.c	same as detex1.c but assumes you have access to getpar()
texeqn1.c	picks displayed equations from a document
texeqn2.c	same as texeqn1.c but assumes you have access to getpar()
texexpand1.c	expands the document by opening \input and \include files
texexpand2.c	same as texexpand1.c but assumes you have access to getpar()
texmatch1.c	checks for matching braces, brackets, parentheses, and dollar signs
texmatch2.c	same as texmatch1.c but assumes you have access to getpar()
DeTeX.c		subroutine to strip TeX's commands from the document
Eqn.c		subroutine to extracts equations
Expand.c	subroutine to expand the document
Match.c		subroutine that checks the matching
subs.c		subroutines used by the programs
detex.man	manual page for detex
texeqn.man	manual page for texeqn
texexpand.man	manual page for texexpand
texmatch.man	manual page for texmatch
tr2tex		directory containing source for troff to LaTeX translator.
		See README file in that directory.
