-*-Text-*-
This is the file INFO;DIR >, which contains the topmost node of the
info hierarchy.  The first time you invoke INFO you start off
looking at that node ( "(INFO;DIR)Top" ).

File: DIR	Node: Top	This is the top of the INFO tree
  This (the Directory node) gives a menu of major topics. 
  Typing "D" returns here, "Q" exits, "?" lists all INFO commands, "H" 
  gives a primer for first-timers, "Mmail<CR>" visits MAIL topic, etc.
  --- PLEASE ADD DOCUMENTATION TO THIS TREE. (See INFO topic first.) ---
* Menu: The list of major topics begins on the next line.
* General information programs::
* New User Info::
* Computer Networks::	Tells about the ARPAnet, Chaosnet, CSNET, et al.
* Text Editors::
* Mail and Message Processing systems::
* Network programs::
* File Utilities::
* Formatting Systems for Text::
* Document Hardcopy Utilities::
* Programming Systems::
* Debugging facilities::
* Terminal Support::
* ITS: ITS
* Simulators::
* Other::

General information programs:

* INFO:	(INFO)Top	INFO is this program.  Look here for how to
			add documentation to the tree.
  ^^ Notice that INFO is the topic, while (INFO)Top is the node name.

* NAME: (.INFO.;NAME ORDER)*
			Provides information about users.

(PEEK, WHOIS, W, LOOKUP, INQUIR, WHEN, etc should be mentioned here)

* METER: (METER)	The METER program prints statistics on system
			use and the frequency of various internal
			events.

New User Info:

* INTRO: (INTRO)Top	This node introduces the beginner to ITS.

Text Editors:

* EMACS: (EMACS)Top	EMACS is an editor / collection of subsystems.
			The documentation is not complete yet.

* DOC: (AI:PRATT;SHTDOC)*
			DOC is an editor with a small set of mnemonic 
			commands that combine in powerful ways.

* TAGS: (TAGS)		TAGS, an EMACS library, remembers the location
			of every tag in one or more files, so you can
			go to any of them very quickly.

* LEDIT: (LEDIT)TOP	LEDIT is a LISP/EMACS interface package which
                        is designed to be used with the TAGS package
                        and the EXPR-HASH feature of LISP.

** LISPT: (LISPT)TOP	LISPT is a package of LISP functions and an
			EMACS macro library to support running editors
			as inferior jobs to a LISP.
			(Note: the actual menu item exists
			but has been moved to the end so as not to
			interfere with menu item LISP).

* MACST: (LISPT)TOP	MACST what the LISPT package is called when
			used with a MACSYMA.

Mail and Message Processing systems:

* MAIL: (MAIL)		MAIL is used to send mail to other users.

* BUG:	(MAIL)BUG	BUG is used to complain about malfunctioning
			system programs.

* QSEND: (MAIL)QSEND	QSEND is used to send immediate messages to
			logged-in users at other ARPAnet sites.

* SENSOR: (SENSOR)	Sends cENSOR - An alternate message receiver

* SENDER: (SENDER)	Multi-function SENDing program.  This is the
			creature that handles :REPLY.

* RMAIL: (RMAIL)	RMAIL is a program for reading, editing, and
			replying to mail.

* Babyl: (Babyl)	Babyl is, like RMail, an EMACS mail subsystem.
			It differs from RMail in some respects; in
			particular, it will run on TENEX and TWENEX.

* ZBabyl: (ZBabyl)	ZBabyl is an experimental extension to Babyl which
			offers some additional features inspired by ZMail.
			Its mail file format is compatible with Babyl's, so
			it is possible to go back and forth.
			New users are encouraged to use normal Babyl.

* Announcements: (SYSMSG)
			All about system-wide announcements on ITS:
			how to read them, how to send them, and which
			ones should go to which addresses.

* GMSGS: (RMAIL)GMSGS	Program for putting system messages in your
			mail file automatically.

* XHOST: (XHOST)	XHOST is a tool for assisting in the conversion of
			mailing list files to use only "approved" host names.

Network programs:

* FTP: (FTP)		FTP transfers files over the ARPAnet.

* SUPDUP: (TELNET)SUPDUP
			SUPDUP is used for logging in to other
			ITS systems or SAIL over the ARPAnet.

* TELNET: (TELNET)	TELNET is used for logging in to other
			hosts on the ARPAnet.

* INSTALL: (.INFO.;INSTAL ORDER)*
			A program for installing files on all ITS's.

* TALK::		A program for talking to users on other net sites
			(No help available)

* TIP: (INFO;TIP >)	Describes simple use of the TIP and gives pointers
			to more comprehensive information

* PCNET: (MC:PCNET;PCNET INFO)	Personal Computer Network

* KERMIT: (KERMIT)	Serial line file transfer program.

File Utilities (Searching, source comparison, Indexing, and other utilities)

* FIND: (FIND)		FIND is a program which searches for files.

* COMB: (FIND)COMB	COMB searches for and prints files.

* LISTF: (FIND)LF	LF is an augmented version of ITS LISTF.

* SRCCOM: (SRCCOM)	SRCCOM can compare two similar text files
			and list their differences, or let you
			merge them into a file "halfway between" them.

* INDEXR: (MC:MACIND;IINFO >)
			The INDEXR program indexes LISP programs.  It
			is easily exstensible to allow collection of
			whatever data on whatever type of form you
			want.  It is being extended to allow indexing
			of references across files for MACSYMA. 

(DIR, DIRED, ARC, etc should be documented here)


Formatting Systems for Text:

* @: (@)		Generates program or text listings with
			cross references, table of contents, etc.

* RENUM: (RENUM)	EMACS macros for renumbering sections, 
			references, equations, etc. in manuscripts.

* RUNOFF: (INFO;RUNOFF >)*
			An EMACS macro using @ LREC for managing
			text processing of large text documents
			with multiple files.

* PR: (INFO;PR >)TOP	Print files on a terminal with various options.

* SPELL: (INFO;SPELL >)
			A program to check spelling.

* TJ6: (MC:.INFO.;TJ6 INFO)*
			One of earlier, simpler text justifiers.

* PUB: (PUB;PUB DOC)*	The document compiler from SAIL.

* R: (INFO;RGUIDE INFO)TOP	
			A machine independent (transportable)
			document processor written in C.

* RGUIDE: (INFO;RGUIDE INFO)TOP
			Same as above.

* RMAN: (R;RDOC LPT)*	R reference manual (you probably DON'T want this).

* TeX: (INFO;TBASE INFO)TOP
			The TeX document formatting program with
			the Basic macro package.

* TBASE: (INFO;TBASE INFO)TOP
			Same as above.

* TeX Updates: (INFO;TEX CONVRT)*
			Some information about updating :TEX
			source files to work under :XTEX.

Document Hardcopy Utilities:

* DOVER: (DOVER)	The program for sending/spooling things to the
			Dover.  It also handles text files, and XGP files
			(after a fashion).
* GLPT:  (GLP)		The Gould electrostatic printer spooler for
* GLP:   (GLP)		printing graphics or text files on the printer
* Gould: (GLP)		in building 38.

* LPDEV: (LPDEV)	The LPDEV family of devices send output to the Imagen,
			Laserwriter, and QMS printers around Tech Sq.

* LPX: (LPX)		The LPX program prints listings on a hardcopy
			terminal as if it were a LPT.

* DIABLO: (MC:DIABLO)	The Diablo program prints a file using the ETX/ACK
			flow control protocol.

* XGP: (XGP)		The XGP spooling system is used to queue files
			to the AI Xerox Graphics printer.

* XD: (XGP)XD		XD displays on a TV files meant for the XGP.
			This can save time, trouble, and paper.

Programming Systems:
(These entries are generally too large to be useful.  Perhaps they will
 be restructured someday...)

* TECO: (TECMAN)TOP
			An editing system in which higher level editor
			packages such as EMACS are written.

* TECOA: (.INFO.;TECO ARCHIV)*
			A record of TECO updates.

* MACLISP: (LISP)	THE programming language on AI, ML, and MC.
			Not found on DM.

* CGOL: (AI:PRATT;CGOLMA)*
			CGOL is an ALGOL-like front-end for MACLISP.

* MACSYMA: (MACSYM)
			A large system for programming mathematical
			calculations, both symbolic and numeric.

* LMLIB: (LMLIB;LMLIB DOC)
			LMLIB; is a community directory for Lisp Machine
			users to store generally useful programs.

* MIDAS: (MIDAS)	The powerful assembly/macro language in which
			most machine language programs on ITS are
			written.
* Assembler: (MIDAS)	No general entry on assemblers.

* PDP-10: (PDP-10)	PDP-10 machine language.  You need this together
			with the documentation of MIDAS itself.

* LIB: (LIB)		The subroutine libraries for MIDAS programs.

* PALX: (.INFO.;PALX ORDER)*
			A cross assembler for PDP-11 assembly language.

* CROSS: (CROSS DOC)*	A cross assembler for 6502, 6800, 8080, 8085, Z80,
			1802, F8[future], and 8008 assembly languages.

* CC: (C;CDOC)		The C programming language developed at Bell Labs.

Debugging facilities:

* DDT: (DDT)		The basic monitor and machine language
			debugger.

* INIT: (INIT)		INIT is a winning DDT INIT program.

* INLINE: (DDT)INLINE	INLINE is a program for reading commands from the TTY
			in DDT INIT files etc.

* TRACE: (Info;Trace >)*
			The Lisp Trace package.

* STEP: (LIBDOC;STEP INFO)*
			A single step evaluator for LISP.

* TDEBUG: (TDEBUG)Top
			TDEBUG provides a stepping facility for
			Teco macros.

* Binprt: (Binprt)*	Prints info on binary files.

Terminal Support:

* Terminals: (TERMS)
			This is a description of various display
			terminals. 

* KTV System: (MC:KTVDOC;KTV INFO)
			This is documentation on the KTV graphics terminal
			concentrators that sit on the Chaos network.

* TCTYP: (.INFO.;TCTYP ORDER)*
			The program to use for informing ITS of
			the characteristics of your terminal
			if the defaults are inadequate.

* CRTSTY: (CRTSTY)
			A program to provide display support for
			terminals not explicitly supported by
			ITS.

* IMGOUT: (IMGOUT)	A program that outputs the rest of the command line
			in image mode to the terminal.  Useful for loading
			function keys and the like.

* REATTACH: (REATTA)
			REATTACH is a program for connecting job-trees
			to terminals.  It can be used to "move" a user
			from one terminal to another, or to switch your
			terminal from your current tree to a different one.

* VTTIME: (VTTIME)	VTTIME is a program for continuously displaying
			time of day and/or elapsed time on VT52 terminals.

Operating System (ITS):

* ITSTTY: (ITSTTY)	Documents the terminal support facilities in ITS.

* XXFILE: (.INFO.;XXFILE INFO)*
			XXFILE is similar to XFILE except that it allows
			you to get your tty back while the file is being 
			executed
Simulators:

* DECUUO: (DECUUO)	DECUUO is a program which emulates the
			monitor calls of TOPS-10, DEC's operating
			system for the PDP-10.

* 11SIM: (.INFO.;PDP11 ORDER)*
			A simulator for PALX programs.

Other:

* CSNET: (CSNET)	The NSF CSnet.

* IMSL: (MC:IMSL)	Math & Statistical Library {available on MC only}

* IMAGES: (AI:VIS;IMAGES)
			Describes the format of image files used in
			AI Lab vision research, and a number of programs
			and LISP functions for dealing with them.

* PW: (AI:PW)		PW is a program for making hard-copy
			output of image files on the Optronics
			photowriter.

* PS: (AI:PS)		PS is a program for producing image files
			on disk from real photographs using the
			Optronics photoscanner.

* CAMERA: (AI:CAMERA)	CAMERA is a program for producing image files
			on disk from the VIDICON TV camera.

* MICROS: (MICROS)	A collection of descriptions of various
			micro-computer systems.

* MMODEM: (DSK:.INFO.;MMODEM ORDER)*	MMODEM is a program for transfering
			files between CP/M microcomputers and ITS.

* DSKUSE: (DSKUSE)	DSKUSE is a program for gathering and printing
                        information about the disk system.

* PHOTO: (PHOTO)	PHOTO is a simple program for capturing the output
			of a terminal session.

* XDIAG: (LMLIB;XDIAG INFO)	A diagram editor for the Lisp Machine, XDIAG
			can make and edit diagrams, save them in files,
			and write them to PRESS files for printing on
			the Dover or mixing with document PRESS files.

(DRAW, WD, GEOMED, DIRED, DIR, ARC, LSPEED, PDSET
 Info programs: DOC, CALL, UUO, HOSTAT, DCSTAT, GLDSTS, DSKUSE, MEMSTA,
 Time programs - TIME, TIMES, DATE, DC, CROCK, NWATCH, ...
 ITS ??)

* LISPT: (LISPT)

Node: General information programs	Up: (DIR)

* Menu:

* INFO:	(INFO)Top	INFO is this program.  Look here for how to
			add documentation to the tree.
  ^^ Notice that INFO is the topic, while (INFO)Top is the node name.

* NAME: (.INFO.;NAME ORDER)*
			Provides information about users.

(PEEK, WHOIS, W, LOOKUP, INQUIR, WHEN, etc should be mentioned here)

* METER: (METER)	The METER program prints statistics on system
			use and the frequency of various internal
			events.


Node: New User Info, Up: (DIR), Next: (INTRO)Top

* Menu:

* INTRO: (INTRO)Top	This node gives a general introduction to ITS
			for a beginning user.



Node: Computer Networks		Up: (DIR)
* Menu:

* CSNET: (CSNET)		The NSF CSnet.

* PCNET: (MC:PCNET;PCNET INFO)	Personal Computer Network

Node: Text Editors	Up: (DIR)

* Menu:

* EMACS: (EMACS)Top	EMACS is an editor / collection of subsystems.
			The documentation is not complete yet.

* DOC: (AI:PRATT;SHTDOC)*
			DOC is an editor with a small set of mnemonic 
			commands that combine in powerful ways.

* TAGS: (TAGS)		TAGS, an EMACS library, remembers the location
			of every tag in one or more files, so you can
			go to any of them very quickly.

* LEDIT: (LEDIT)TOP	LEDIT is a LISP/EMACS interface package which
                        is designed to be used with the TAGS package
                        and the EXPR-HASH feature of LISP.

* LISPT: (LISPT)TOP	LISPT is a package of LISP functions and an
			EMACS macro library to support running editors
			as inferior jobs to a LISP.

* MACST: (LISPT)TOP	MACST what the LISPT package is called when
			used with a MACSYMA.


Node: Mail and Message Processing systems	Up: (DIR)

* Menu:

* MAIL: (MAIL)		MAIL is used to send mail to other users.

* BUG:	(MAIL)BUG	BUG is used to complain about malfunctioning
			system programs.

* QSEND: (MAIL)QSEND	QSEND is used to send immediate messages to
			logged-in users at other ARPAnet sites.

* RMAIL: (RMAIL)	RMAIL is a program for reading, editing, and
			replying to mail.

* Announcements: (SYSMSG)
			All about system-wide announcements on ITS:
			how to read them, how to send them, and which
			ones should go to which addresses.

* GMSGS: (RMAIL)GMSGS	Program for putting system messages in your
			mail file automatically.

* XHOST: (XHOST)	XHOST is a tool for assisting in the conversion of
			mailing list files to use only "approved" host names.


Node: Network programs	Up: (DIR)

* Menu:

* FTP: (FTP)		FTP transfers files over the ARPAnet.

* SUPDUP: (TELNET)SUPDUP
			SUPDUP is used for logging in to other
			ITS systems or SAIL over the ARPAnet.

* TELNET: (TELNET)	TELNET is used for logging in to other
			hosts on the ARPAnet.

* INSTAL: (.INFO.;INSTAL ORDER)*
			A program for installing files on all ITS's.
* TALK:

* TIP: (INFO;TIP >)	Describes simple use of the TIP and gives pointers
			to more comprehensive information

* KERMIT: (KERMIT)	Serial line file transfer program.

Node: File Utilities	Up: (DIR)

 (Searching, source comparison, Indexing, and other utilities)

* Menu:

* FIND: (FIND)		FIND is a program which searches for files.

* COMB: (FIND)COMB	COMB searches for and prints files.

* LISTF: (FIND)LF	LF is an augmented version of ITS LISTF.

* SRCCOM: (SRCCOM)	SRCCOM can compare two similar text files
			and list their differences, or let you
			merge them into a file "halfway between" them.

* INDEXR: (MC:MACIND;IINFO >)
			The INDEXR program indexes LISP programs.  It
			is easily exstensible to allow collection of
			whatever data on whatever type of form you
			want.  It is being extended to allow indexing
			of references across files for MACSYMA. 

(DIR, DIRED, ARC, etc should be documented here)
 Instant description of DIR: Pseudo-device lets you list files in sequence
  or reverse sequence by SIZE, date written (CDATE), date read (RDATE) etc.
  For example :PRINT DIR:SYS1;RDATE UP <cr>, or :PRINT DIR:.MSGS.;CDATE DOWN.
 Instant documentation for DIRED: Get into EMACS, say M-X DIRED <esc> <cr>,
  then press ? for help. One file per line is shown, move cursor to desired
  line and issue command to delete or otherwise change status of file,
  Q (quit) to actually delete files marked to delete then return to EMACS.
(Also, there should be a pointer here to info about simple DDT commands
 for manipulating files, like :PDUMP and :LOAD etc.)

Node: Formatting Systems for Text	Up: (DIR)

* Menu:

* @: (@)		Generates program or text listings with
			cross references, table of contents, etc.

* PR: (PR)TOP
			Print files on a terminal with various options.

* SPELL: (SPELL)TOP
			A program to check spelling.

* TJ6: (MC:.INFO.;TJ6 INFO)*
			One of earlier, simpler text justifiers.

* PUB: (MC:PUB;PUB DOC)*
			The document compiler from SAIL.
* R: (INFO;RGUIDE INFO)	A machine independent (transportable)
			document processor written in C.

* RGUIDE: (INFO;RGUIDE INFO) Same as above.

* RMAN: (R;RDOC LPT)*	R reference manual (you probably DON'T want this).

* RENUM: (RENUM)	EMACS macros for renumbering sections, 
			references, equations, etc. in manuscripts.

* RUNOFF: (INFO;RUNOFF >)*
			An EMACS macro using @ LREC for managing
			text processing of large text documents
			with multiple files.


Node: Document Hardcopy Utilities	Up: (DIR)

* Menu:

* DOVER: (DOVER)	The program for sending/spooling things to the
			Dover.  It also handles text files, and XGP files
			(after a fashion).
* GLPT:  (GLP)		The Gould electrostatic printer spooler for
* GTPL:  (GLP)		printing graphics or text files on the printer
* Gould: (GLP)		in building 38.

* LPDEV: (LPDEV)	The LP7:, LP8:, LP9: and LR7: devices send output
			to the Laserwriter and QMS printers around Tech Sq.

* LPX: (LPX)		The LPX program prints listings on a hardcopy
			terminal as if it were a LPT.

* XGP: (XGP)		The XGP spooling system is used to queue files
			to the AI Xerox Graphics printer.

* XD: (XGP)XD		XD displays on a TV files meant for the XGP.
			This can save time, trouble, and paper.


Node: ITS			Up: (DIR)

These entries describe features of the Incompatible Operating System!

* Menu:

* TTY: (ITSTTY)

* XXFILE: (.INFO.;XXFILE INFO)*
     
			XXFILE is similar to XFILE except that it allows
			you to get your tty back while the file is being 
			executed

* DDT: (DDT)


Node: Programming Systems	Up: (DIR)
(These entries are generally too large to be useful.  Perhaps they will
 be restructured someday...)

* Menu: 

* TECO: (.INFO.;TECO ORDER)*
			An editing system in which higher level editor
			packages such as EMACS are written.

* TECOA: (.INFO.;TECO ARCHIV)*
			A record of TECO updates.

* MACLISP: (LISP)	THE programming language on AI, ML, and MC.
			Not found on DM.

* CGOL: (AI:PRATT;CGOLMA)*
			CGOL is an ALGOL-like front-end for MACLISP.

* MACSYMA: (MACSYM)
			A large system for programming mathematical
			calculations, both symbolic and numeric.

* MIDAS: (MIDAS)	The powerful assembly/macro language in which
			most machine language programs on ITS are
			written.

* PDP-10: (PDP-10)	PDP-10 machine language.  You need this together
			with the documentation of MIDAS itself.

* LIB: (LIB)		The subroutine libraries for MIDAS programs.

* PALX: (.INFO.;PALX ORDER)*
			A cross assembler for PDP-11 assembly language.

* CROSS: (CROSS DOC)*	A cross assembler for 6502, 6800, 8080, 8085, Z80,
			1802, F8[future], and 8008 assembly languages.

* CC: (C;CDOC)		The C programming language developed at Bell Labs.

Node: Debugging facilities	Up: (DIR)

* Menu:

* DDT: (DDT)		The basic monitor and machine language
			debugger.

* INIT: (INIT)		INIT is a winning DDT INIT program.

* INLINE: (DDT)INLINE	INLINE is a program for reading commands from the TTY
			in DDT INIT files etc.

* STEP: (LIBDOC;STEP INFO)*
			A single step evaluator for LISP.

* TDEBUG: (TDEBUG)
			TDEBUG provides a stepping facility for
			Teco macros.

* BINPRT: (BINPRT)*	Prints data about file's assembly.

Node: Terminal Support		Up: (DIR)

* Menu:

* Terminals: (TERMS)
			This is a description of various display
			terminals. 

* TCTYP: (.INFO.;TCTYP ORDER)*
			The program to use for informing ITS of
			the characteristics of your terminal
			if the defaults are inadequate.

* KTV System: (MC:KTVDOC;KTV INFO)
			This is documentation on the KTV graphics terminal
			concentrators that sit on the Chaos network.

* CRTSTY: (CRTSTY)
			A program to provide display support for
			terminals not explicitly supported by
			ITS.

* REATTACH: (REATTA)
			REATTACH is a program for connecting job-trees
			to terminals.  It can be used to "move" a user
			from one terminal to another, or to switch your
			terminal from your current tree to a different one.

* ITSTTY: (ITSTTY)	Documents the terminal support provided by ITS.


Node: Simulators	Up: (DIR)

* Menu:

* DECUUO: (DECUUO)	DECUUO is a program which emulates the
			monitor calls of TOPS-10, DEC's operating
			system for the PDP-10.

* 11SIM: (.info.;PDP11 ORDER)*
			A simulator for PALX programs.
