.!==========================================================================
.!!	Overall help library source file for the TEXTOOLS on line help.
.!==========================================================================

.hl	help_TeX

	This help library provides an on line description of the tools
and other objects that are defined for using the Version V1.0-3 of the
TeX and LaTeX system.
Tools (and files) are indicated by UPPERCASE, and informational
topics are in mixed (or lower) case.

.hl	Hints
	The following informational topics are available to you.
.lit

	TeX_Setup	Description of the site SET*.COM files.
	TeX_Documents	Additional documentation.
	TeX_Files	Description of what files TeX, LaTeX use.
	TeX_Logicals	Describes the various logical names used.
.end	lit
.!
.!--------------------------------------------------------------------------
.!	Description of documents that are available.
.!--------------------------------------------------------------------------

.hl	TeX_Documents
.sl	+1

	The following files are available as on line documents that you
can print out.  Files of type .PS are Postscript files that can be printed
on an Apple Laserwriter, while files of type .LN3 can be printed on an
LN03 printer with "/NOFEED" qualifier.

.list

.le	;TEX_ROOT:[DOC]CHEAT_SHEET.PS

	One page summary of available commands.

.le	;TEX_ROOT:[DOC]CHEAT_SHEET.LN3

	Same as .PS version.

.!	.le	;TEX_ROOT:[DOC]CHEAT_SHEET.DVI
.!	
.!		LaTeX DeVice Independent (DVI) file that can be used to generate
.!	output for other devices (using proper DVI* tool).

.!	.le	;TEX_ROOT:[DOC]LOCAL.PS
.!	
.!		Locally tailored LaTeX guide.
	
.end	list

.hl	TeX_manual

	The complete source file for the TeXbook is to be found
in the following file.
.lit

	TEX_ROOT:[DOC.TEX]TEXMAN.TEX
.end	lit

.hl	Metafont_manual
	The complete source file for the Metafont book is to be found
in the following file.
.lit

	TEX_ROOT:[DOC.TEX]MFMAN.TEX
.end	lit

.hl	WEB_manual
	The complete source file for the WEB manual is to be found
in the following file.
.lit

	TEX_ROOT:[DOC.TEX]WEBMAN.TEX
.end	lit

.sl	-1				.! Documents
.!
.!--------------------------------------------------------------------------
.!	Description of what files TeX uses.
.!--------------------------------------------------------------------------

.hl	TeX_Files
.sl	+1

	The following are the various file types that TeX (and other related
tools) make use of.

.hl	.AUX
.sl	+1
	This is an auxiliary information file that contains
cross-referencing information.
	If LaTeX is run with an input file named MYFILE.TEX that has citations
and bibliography making commands.  The auxiliary file MYFILE.AUX that it
produces will contain all the citation keys and the arguments of the
"\bibliography" and "\bibliographystyle" commands.
	This is also an input file to the BibTeX program.
.sl	-1			.! .AUX

.hl	.BBL
.sl	+1

	BiBTeX output file, that is read by LaTeX when it encounters a
"\bibliography" command.

.sl	-1			.! .BBL

.hl	.DVI
.sl	+1
	DeVice Independent file that is output by TEX.  This is then used
as input for the driver to convert the DVI file to a file that can be printed
on the particular output device.

.sl	-1			.! .DVI

.hl	.GDF
.sl	+1
	Glossary definition file.  This is a text file which contains one
or more definitions of words or phrases (and 'entry') in a special defined
format.

.sl	-1			.! .GDF

.hl	.GF
.sl	+1
	An output file from METAFONT that is the actual raster image
of the characters.
.sl	-1			.! .GF

.hl	.GLG
.sl	+1
	Glossary log file, that is created when GloTeX is run.
.sl	-1			.! .GLG

.hl	.GLO
.sl	+1
	Glossary information file that is created by LaTeX.  This is then used
as input to the GloTeX program.
.sl	-1			.! .GLO

.hl	.GLS
.sl	+1
	GloTeX output file.  This is input into your LaTeX document with
a "\input{name.GLS}" command at the appropriate place.
.sl	-1			.! .GLS

.hl	.IDX
.sl	+1
	Auxiliary Index file.  This is created by LaTeX by the
"\makeindex" command in the preamble of the document.
	This is the input file to the IdxTeX program.
.sl	-1			.! .IDX

.hl	.IND
.sl	+1
	IdxTeX output file, that contains all of the commands necessary to
create an attriactive two-column index.
This file is included in the LaTeX document with an "\input" command at
the appropriate place.
.sl	-1			.! .IND

.hl	.LIS
.sl	+1
	Listing/log file that is generated when TEX is run.
.sl	-1			.! .LIS

.hl	.TEX
.sl	+1
	TeX (and LaTeX) input source file.  This is the default file type
that is assumed for all input files.  You are free to use another file type
if you specify it.

.sl	-1			.! .TEX
.hl	.TFM
.sl	+1
	This is a TeX Font Metric, which defines the size and position
details of each character.
TeX reads these when it composes a document.
.sl	-1			.! .TFM

.hl	.TOC
.sl	+1
	Table of Contents file.  This is generated by LaTeX and contains
information for generating the Table of Contents for a document.

.sl	-1			.! .TOC

.hl	.PS
.sl	+1
	Postscript file, that can be sent to a printer such as an Apple
Laserwriter.
.sl	-1			.! .PS

.sl	-1			.! TeX_Files
.!
.!--------------------------------------------------------------------------
.!	Description of SET*.COM files
.!--------------------------------------------------------------------------

.hl	TeX_Setup
.sl	+1

	These tools are set up with the use of three special DCL command
procedures in the top directory of the toolkit.  By running them you
have defined all that you need to use all of these tools.

.hl	SETUP.COM
.sl	+1
.req	"SETUP.COM_RNO"
.sl	-1

.hl	SETLOGS.COM
.sl	+1
.req	"SETLOGS.COM_RNO"
.sl	-1

.hl	SETSYMBS.COM
.sl	+1
.req	"SETSYMBS.COM_RNO"
.sl	-1

.sl	-1				.! Setup_Files
.!
.!--------------------------------------------------------------------------
.!	Description of the logical names that get defined.
.!--------------------------------------------------------------------------
.hl	TeX_Logicals
.sl	+1
	All necessary logical names are defined in the SETLOGS.COM file,
and provide a way to conveniently reference files and directories on any
system.

.hl	LATEX$STYLES
.sl	+1

	This points to the directory that contains the latest copies of
the LaTeX style sheets, from the Rochester University system.

.sl	-1				.! LATEX$STYLES

.hl	MF$BASES
.sl	+1

	This points to a directory that is used by the METAFONT tool.
.sl	-1				.! MF$BASES

.hl	MF$INPUTS
.sl	+1

	This points to the directory that is where to find any METAFONT input
files that are not to be found in the current default directory.

.sl	-1				.! MF$INPUTS

.hl	TEX$BIB
.sl	+1

	Points to the directory containing all of the various
BibTeX files.

.sl	-1				.! TEX$BIB

.hl	TEX_EXE
.sl	+1

	Directory that contains the executable files for the TeX, LaTeX,
and other systems.

.sl	-1				.! TEX_EXE

.hl	TEX$FONTS
.sl	+1

	Directory that contains the TeX Font Metric (TFM) files.

.sl	-1				.! TEX$FONTS

.hl	TEX$FORMATS
.sl	+1
.sl	-1				.! TEX$FORMATS

.hl	TEX$HELP
.sl	+1

	Directory containing all of the files that are necessary for
the on line help support for this toolkit.

.sl	-1				.! TEX$HELP

.hl	TEX$HLB
.sl	+1

	On line help library for the TEXTOOLS.

.sl	-1				.! TEX$HLB

.hl	TEX$INPUTS
.sl	+1

	Directory to use for TeX and LaTeX input files, that are not
in the current default directory.  This is where you will find standard
include files, LaTeX styles (*.STY) and other files.

.sl	-1				.! TEX$INPUTS

.hl	TEX$LOCAL
.sl	+1

	Directory containing the local files for using TeX and LaTeX.
.sl	-1				.! TEX$LOCAL

.hl	TEX$PKDIR
.sl	+1
.sl	-1				.! TEX$PKDIR

.hl	TEX$PXLDIR
.sl	+1
.sl	-1				.! TEX$PXLDIR

.hl	TEX_ROOT
.sl	+1
	Logical device that is the root of ALL of the various directories
for this toolkit.
.sl	-1				.! TEX_ROOT

.hl	TEX_FONTS
.sl	+1

	Alternate form for the logical TEX$FONTS.

.sl	-1				.! TEX_FONTS

.hl	TEX_INPUTS
.sl	+1

	Alternate form for the logical TEX$INPUTS.

.sl	-1				.! TEX_INPUTS

.hl	USER$INPUTS
.sl	+1

	User defined directory of TeX and LaTeX styles, etc.  This can be
defined by you to point to a directory of your files you want to supercede
those in TEX$INPUTS.

.sl	-1				.! USER$INPUTS

.sl	-1				.! TeX_Logicals

.!
.!--------------------------------------------------------------------------
.!	The following are DCL commands that are defined as part of the
.!	SETSYMBS.COM file.
.!--------------------------------------------------------------------------

.hl	BIBTEX
.sl	+1
.req	"bibtex.rno"
.sl	-1			.! xxx

.hl	DVI2PS
.sl	+1
	Converts DVI files into Postscript (*.PS) files that can be printed
out on an Apple Laserwriter printer.
.lit

	$ DVI2PS  dvi-file
					or
	$ DVI2PS -B  dvi-file			! reverse order on output
.end	lit
.sl	-1			.! xxx

.hl	DVIALW
.sl	+1
	Converts DVI files into Postscript (*.PS) files that can be printed
out on an Apple Laserwriter printer.
.lit

	$ DVIALW  dvi-file
					or
	$ DVIALW -B  dvi-file			! reverse order on output
.end	lit
.sl	-1			.! xxx

.hl	DVITYPE
.sl	+1
	This is a METAFONT tool, which is described in the METAFONT book.
.sl	-1			.! DVITYPE

.hl	GFTODVI
.sl	+1
	This is a METAFONT tool, which is described in the METAFONT book.
.sl	-1			.! GFTODVI

.hl	GFTOPK
.sl	+1
	This is a METAFONT tool, which is described in the METAFONT book.
.sl	-1			.! GFTOPK

.hl	GFTOPXL
.sl	+1
	This is a METAFONT tool, which is described in the METAFONT book.
.sl	-1			.! GFTOPXL

.hl	GFTYPE
.sl	+1
	This is a METAFONT tool, which is described in the METAFONT book.
.sl	-1			.! GFTYPE

.hl	INIMF
.sl	+1
	Initializes METAFONT.
.sl	-1			.! xxx

.hl	INITEX
.sl	+1
	Initializes TeX.
.sl	-1			.! xxx

.hl	MF
.sl	+1
	Invoke METAFONT for designing fonts.  For more information, see
"The METAFONT Book" by Donald Knuth.

.sl	-1			.! MF

.hl	PLTOTF
.sl	+1
	This is a METAFONT tool, which is described in the METAFONT book.
.sl	-1			.! PLTOTF

.hl	POOLTYPE
.sl	+1
	This is a METAFONT tool, which is described in the METAFONT book.
.sl	-1			.! POOLTYPE

.hl	TANGLE
.sl	+1
	WEB 'compiler' that converts WEB programs into Pascal code that can
then be compiled using the local Pascal compiler.
.lit

	$ TANGLE   name
	$ PASCAL   name
.end	lit
.sl	-1			.! TANGLE

.hl	TEX
.sl	+1

.!	the following is from DECUS Proceedings, Spring 1986, page 289.
.!	
	TeX is a powerful language that offers nearly unlimited flexibility
in composing and typesetting difficult material.
It was originally designed (by Donald Knuth) to typeset mathematics and allows
very complex mathematical formulations to be set precisely as the
mathematician desires.
.lit

	$ TEX  [tex-file]
.end	lit

	The principle reference for using TeX is the TeXbook, by Donald
E. Knuth.

.hl	logo

	The three letters of the TeX logo (when typeset) are the Greek
letters Tau Epsilon Chi, pronounced 'techhh'.

.sl	-1			.! TEX

.hl	TEXIDX
.sl	+1
	Another Index generating tool for TeX documents.
.sl	-1			.! TEXIDX

.hl	TFTOPL
.sl	+1
	This is a METAFONT tool, which is described in the METAFONT book.
.sl	-1			.! TFTOPL

.hl	WEAVE
.sl	+1
	Converts a WEB file into a TeX source that you can then use to
generate a document on the program.  The following will generate the file
"name.TEX" from the input file "name.WEB".
.lit

	$ WEAVE name	
.end	lit

	WEAVE expects that there will be a change file (default name is
"name.CH").  If none exists, then you will be prompted for one.

.sl	-1			.! WEAVE