Release Notes
=============

This are the Release Notes for Testing Techs free Java-based TTCN-3
Parser TTthreeParser v1.4  They cover the following topics:

  - What's new
  - Copyright	
  - Introduction
  - Distribution
  - System Requirements
  - Installation & Execution
  - Uninstall
  - Further Information


Please read them carefully before your proceed.

What's new in v1.4
------------------
Modifications had become neccessary as a new BNF version has been re-
leased by ETSI in May 2001. The parser now complies to the ETSI
document version ES 201 873-1 v1.0.11.


Copyright
---------
         ---- TTthreeParser v1.4 ----

Copyright (C) 2000 Testing Technologies IST GmbH

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
USA.

Contact Information

Testing Technologies IST GmbH
Bernburger Str. 24-25
10963 Berlin, Germany

tel +49 30 3480 77 80
fax +49 30 3480 77 81

email: ttcn-3@testingtech.de
www  : www.testingtech.de


Introduction
-------------

TTthreeParser v1.4 is a Java-based TTCN-3 Parser covering the latest
TTCN-3 BNF Syntax (Rev. 11). 

It provides a full syntactic analysis and constructs an abstract
syntax tree for you convenience. Error messages produced by the parser
are suitable for the usage within emacs or xemacs in compilation mode.

However we kindly ask for some feedback so that we are able to
improve the parser further.
	- Did you experience any problems using the parser? 
	- Does Java seems for you the right choice?

In case you want to give us some feedback please contact us via email
at ttcn-3@testingtech.de


Distribution
------------

The TTthreeParser v1.4 distribution contains:
 - Lexer and Parser for ANTLR (TTCN3Lexer.g; TTCN3Parser.g)
 - Java-files to demonstrate the usage of the parser
 - A TTCN-3 version of the INRES example (test.ttcn3)
 - CLASS-files for immediate execution
 - Makefile to build the parser from scratch

The ANTLR package needed to translate the grammar-files to Java IS NOT
included in this distribution.


System Requirements
-------------------

General:
A system being capable running JAVA 2 should be sufficient. We
successfully compiled and run the parser on several Linux, Solaris and
WinNT/2000 installations.

While the parsing itself is quite fast for Java the Java-code
generation using ANTLR may take some time on slower machines.

ANTLR:
You will need to have ANTLR installed on your system. ANTLR can be found at
http://www.antlr.org.

JIKES: 
Jikes is a very fast Java-compiler developed at IBM. It's usage
is encouraged but not necessary. You can find jikes at 
http://oss.software.ibm.com/developerworks/opensource/jikes/


Installation an Execution
-------------------------

- Make sure you have java in your path
- Unpack the tgz-distribution
- go to installation directory
- make sure your CLASSPATH is set correctly, including the ANTLR jar-file.

Compile:
- translate the Grammar-files and compile them by typing
  gmake (GNU make)

NOTE: The Makefile provided in this distribution assumes that jikes is
installed on your system and available via the path variable. In case
you have not installed jikes but javac uncomment/comment the
appropriate variables.

- If everything is configured fine, first the grammar files will be
translated and afterwards the generated java-files will be compiled.

Run:
- Run the parser by typing
  java TTCN3Tool [ttcn3-file]
  If no filename is provided the parsers searches for a file called test.ttcn3


Uninstall
---------

For uninstalling TTthreeParser simply delete the installation
directory.


Further Information
-------------------

Check out http://www.testingtech.de for further products on TTCN-3 or
http://www.etsi.org/ptcc/ptcc_ttcn3.htm for more information on
TTCN-3.
