ANTLR v3.1 .NET Runtime Library (for us with the ANTLR C# Code Generator)
|
|
29 September, 2007
|
|
Kunle Odutola : kunle UNDERSCORE odutola AT hotmail DOT com
|
Micheal Jordan
|
|
1. INTRODUCTION
|
|
The ANTLR v3.1 .NET Runtime Library extend the ANTLR language processing
|
tools generator to the C#/CLI platforms such as Microsoft .NET,
|
Novell/Ximian Mono and dotGNU. It is written in the C# programming language
|
and was designed specifically for use with the ANTLR C# Code Generation
|
target but, it would work equally well with a VB.NET, C++/CLI or indeed
|
IronPython code generator were such a thing to be developed for ANTLR v3.1.
|
|
We hope you find the ANTLR v3.1 .NET Runtime Library delightful and useful
|
even but, as per the license under which you may use it, this software is not
|
guaranteed to work.
|
|
Please see LICENSE.TXT for the full text of the license and NOTICE.TXT
|
for attribution notices.
|
|
|
2. WHAT'S IN THE PACK?
|
|
This distribution contains three projects, the project files needed to
|
build them with Microsoft Visual Studio 2003 & 2005 and, Nant build files.
|
|
The projects are:
|
|
1. Antlr3.Runtime - the ANTLR v3.1 .NET Runtime Library
|
|
2. Antlr3.Utility - the ANTLR v3.1 .NET Runtime Utility Library
|
|
3. Antlr3.Runtime.Tests - the ANTLR v3.1 .NET Runtime Library Tests
|
|
In addition the Libraries sub-directory contains externals dependencies.
|
|
2.1 Dependencies
|
|
1. Antlr3.Runtime - none
|
|
2. Antlr3.Utility - Antlr3.Runtime.dll
|
StringTemplate.dll
|
antlr.runtime.dll
|
|
3. Antlr3.Runtime.Tests - Antlr3.Runtime.dll
|
StringTemplate.dll
|
antlr.runtime.dll
|
|
In addition, Antlr3.Runtime.Tests has a dependency on the MbUnit v2.4 dlls.
|
|
|
3. USING The ANTLR v3.1 .NET Runtime Library
|
|
Tou use the ANTLR v3.1 .NET Runtime Library in your projects, add a
|
reference to the following file in your projects:
|
- Antlr3.Runtime.dll
|
|
If you are using StringTemplate out in your grammar, add the following
|
files too:
|
- StringTemplate.dll
|
- antlr.runtime.dll
|
|
You can find examples of using ANTLR v3.1 and the ANTLR v3.1 .NET Runtime
|
Library at:
|
http://www.antlr.org/download/examples-v3.tar.gz
|
|
|
4. BUILDING The ANTLR v3.1 .NET Runtime Library
|
|
If you wish to re-build The ANTLR v3.1 .NET Runtime Library for any reason, this
|
is what you need to know.
|
|
nant clean
|
nant release -t:net-1.1
|
or
|
nant clean
|
nant release -t:net-2.0
|
|
|
5. ANTLR v3.1 .NET Runtime Library STATUS
|
|
This release of the ANTLR v3.1 .NET Runtime Library is a stable beta release.
|
|
There are currently 0 failures in the unit test suite.
|
|
|
Don't forget to visit the www.antlr.org for further info. The mailing lists
|
are (currently) low volume and have a very high Signal-to-Noise ratio. We'd
|
like to hear about how you're using ANTLR v3.1 and the .NET Runtime Library.
|
|
|
7. CONTRIBUTORS
|
|
Kunle Odutola
|
Micheal Jordan
|
|
|
Enjoy!
|
|
Kunle Odutola
|
