CSharp3 Target and C# Ports of the ANTLR Tool and StringTemplate

Documentation

The latest version of the CSharp3 target documentation is located at the following link:
Visual Studio and the ANTLR C# Target

While the document focuses on Visual Studio 2010, everything except section 1.1 can be applied to Visual Studio 2008. Also, this document is currently limited to instructions for setting up a Visual Studio project to work with the CSharp3 target, along with descriptions of a few substantial features unique to the CSharp3 target.

Releases

Depending on your particular needs, several packages are available for each release. The packages are compressed with 7-zip.

Runtime: This package includes Antlr3.Runtime.dll. Generated grammars using the CSharp3 target depend on this assembly, so you'll need to ship it with your application. Starting with release 3.3.3, this package also includes the symbol files (*.pdb) for the binaries.
Bootstrap: This package includes everything necessary to generate and execute grammars using the CSharp3 target in a Visual Studio project. This package includes the C# port of the ANTLR tool for generating grammars, but no other language targets are included.
Tool: This package includes the C# port of the ANTLR tool, plus templates for generating code for any supported language target. Starting with release 3.3.1, this package also includes the symbol files (*.pdb) for the binaries.
Source: This package includes the source code for the CSharp3 target runtime, as well as the source for the C# ports of the ANTLR Tool and StringTemplate.
ST3: This package contains the binaries for StringTemplate 3, including the required CSharp3 runtime and symbol files for the binaries.
ST4: This package contains the binaries for StringTemplate 4, including the required CSharp3 runtime and symbol files for the binaries.

	Runtime	Bootstrap	Tool	Source	ST3	ST4
CSharp3 Runtime (Antlr3.Runtime.dll)	X	X	X		X	X
C# Port of Tool (Antlr3.exe)		X	X
CSharp3 Target for Tool		X	X
MSBuild integration for the CSharp3 target		X	X
C# Port of StringTemplate 3 (Antlr3.StringTemplate.dll)		X	-³		X
C# Port of StringTemplate 4 (Antlr4.StringTemplate.dll)		X	X³			X
Other Targets for Tool			X
Symbol Files (*.pdb)	X²		X¹		X	X
Source Code				X

¹ Starting with version 3.3.1.
² Starting with version 3.3.3.
³ The Tool now uses StringTemplate 4, starting with version 3.3.3.

Latest Stable Release

The latest stable release is 3.3.0, which is up-to-date with version 3.3 of the Java tool and target. When using this version, grammars may be generated by either the C# port of the ANTLR Tool (Antlr3.exe), or by the original Java version of the tool.

Latest Preview Release

Compatibility Note: Due to some template changes which are incompatible with the targets, this version of the C# port of the Tool can only be used to generate code for the CSharp3 target version 3.3.1. In addition, only the C# port of the Tool can be used to generate code for this version of the CSharp3 target. If you are working in Visual Studio and using the MSBuild integration with the CSharp3 target, this is not likely to cause problems. If you are using other language targets (Java, C, etc.), or use the Java version of the Tool to generate your grammars (for example, in ANTLRWorks), then you'll want to wait for the next release.