
                   TALK 2.11 - TALK 3.0 TRANSLATOR
                   ===============================

The application 'trans-source' partially translates a Talk 2.11 source
file with the extension '.ll' into a Talk 3.0 source file with the
extension '.t'.  The new source file is annotated with warnings
wherever trans-source cannot guarantee a correct translation. These
warnings are summarized on the last line, and can found with a simple
grep. A few literals cannot be translated and are signaled by inserting the string "#<OLD-SYNTAX>" in the output.

The script 'trans-descr' translates a Talk 2.11 program unit description
file with an '.lm' extension into a Talk 3.0 program unit description
file with a '.td' extension.  This script is used by 'trans-tree',
described below.

The script 'trans-tree' calls 'trans-source' and 'trans-descr' for
each module of the subtree passed as the first argument, and creates
corresponding files and directories under its second argument.  The
'trans-tree' script will not translate modules if there are any
potential problems; please read the error messages so that you can
make a second attempt which is more successful.

The Makefile constructs the necessary files on your machine, and there
is an example .ll file called 'test.ll' so you can see the results of
the scripts.

$ make
$ trans-source /nfs/project54/src/mymodule.ll mypackage
$ trans-tree /nfs/project54 /tmp/test54-Talk3
