=========== README ============
MakeIndex is Copyright (C) 1987 by Pehong Chen (phc@berkeley.edu)
All rights reserved.

MakeIndex is a general purpose index processor.  This
directory contains this README file, a src directory, a doc
directory, a mac directory, and a paper directory.

The doc directory contains

makeindex.info		an Emacs (TOPS-20 and Gnu) INFO node
			produced automatically from
			makeindex.vms by vmshelp (available
			from Utah)

makeindex.l		a Unix man page

makeindex.ps		PostScript translation of makeindex.l

makeindex.tex		documentation for the use under
			LaTeX by Leslie Lamport

makeindex.vms		VAX VMS equivalent of makeindex.l
			suitable for inclusion in a local
			help library

readme			this file

The src directory contains the C source of MakeIndex.  This
current version is known to compile and run on UNIX (cc and
gcc) VAX/VMS (VMS cc), TOPS-20 (kcc-20 and pcc-20), and IBM
PC DOS (Microsoft C Version 5.0); Atari ST support is
present as well, but has not been tested as of late January
1988.

Type make to compile under UNIX.  Makefiles for the other
operating systems are included as well.  Implementations of
Make for them are available as part of the Utah DVI driver
distribution (send e-mail to beebe@science.utah.edu).

Early porting work was carried out by Charles Karney
(karney%ppc.mfenet@nmfecc.arpa) at Princeton University and
David J. Buerger (dbeurger%scu.bitnet@jade.berkeley.edu) at
Santa Clara University.  These efforts were independent of
the port to PC DOS, TOPS-20, VAX VMS, and the draft-ANSI C
environment for version 2.3 carried out by Nelson H.F. Beebe
(beebe@science.utah.edu).  That port is described in the
file 00revhst.txt in the src directory.

For a detailed discussion on the design of MakeIndex, please read

	Pehong Chen and Michael Harrison, ``Automating Index
	Preparation'', Tech. Report No. 87/347, Computer
	Science Division, University of California,
	Berkeley, March 1987.

A version of this report is included in the doc directory.
A somewhat condensed version entitled

	``Issues in Preparing and Processing Indexes''

has been submitted for publication.


					Pehong Chen
					11-17-1987

					Nelson H.F. Beebe
					28-Jan-88