*************************************************************************
*									*
*  Mtc									*
*									*
*  Modula-2 to C Translator						*
*									*
*  Author: M. Martin							*
*									*
*  Copyright (c) 1990 by						*
*									*
*  Gesellschaft fuer Mathematik und Datenverarbeitung			*
*  (German National Research Center for Computer Science)		*
*  Forschungsstelle fuer Programmstrukturen				*
*  an der Universitaet Karlsruhe					*
*									*
*  All rights reserved.	GMD assumes no responsibility for the use	*
*  or reliability of its software.					*
* 									*
*************************************************************************


Direct requests, comments, questions, and error reports to:

	Josef Grosch
	GMD Forschungsstelle
	Vincenz-Priessnitz-Str. 1
	D-7500 Karlsruhe 1

	Phone: +721-662226
	Email: grosch@karslruhe.gmd.de


The directories and their contents are as follows:

directory	contents
--------------------------------------------------
README		this file
src		source files in Modula-2
m2c		source files in C
doc		documentation
make		makefile generator


Documentation:
--------------

doc/mtc.1	manual page
doc/mtc.roff	Diplomarbeit in troff format: pic | tbl | eqn | ditroff (no macros)
doc/mtc.ps	Diplomarbeit in Postsrcipt format


Installation:
-------------

Before the compilation of mtc, the library of reusable modules called
'reuse' must be compiled.

When moving from little-endian to big-endian machines or vice versa
(like e. g. VAX and MC 68000) the binary files Scan.Tab and Pars.Tab
have to be converted:

   cd src; make bin.conv
   cd m2c; make bin.conv
   cd make; make bin.conv

To generate and install mtc use one of the following:

   cd src; make mtc install BIN=... LIB=...
   cd m2c; make mtc install BIN=... LIB=...

To obtain information on how to use mtc execute:

   mtc -h

To generate and install the makefile generator called makemake use:

   cd make; make GetImports install BIN=... LIB=...

or

   cd make; make -f MakefileC GetImports install BIN=... LIB=...

While the first command compiles the Modula-2 sources,
the second one compiles the C sources of the program GetImports.


Makefile-Generator:
-------------------

Usage:

   makemake [directories]

Makemake inspects the Modula-2 sources in the given directories (default:
working directory) and writes a makefile on stdoutput. The makefile describes
the dependencies of the C sources produced by mtc out of Modula-2 sources.
It also describes the translation of Modula-2 sources to C.

   make sources		: calls mtc to convert all Modula-2 sources to C
   make all		: calls cc to compile and link all C programs
