<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv=Content-Type content="text/html; charset=us-ascii">
<meta name=Generator content="Microsoft Word 12 (filtered medium)">
<style>
<!--
/* Font Definitions */
@font-face
{font-family:Wingdings;
panose-1:5 0 0 0 0 0 0 0 0 0;}
@font-face
{font-family:SimSun;
panose-1:2 1 6 0 3 1 1 1 1 1;}
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Consolas;
panose-1:2 11 6 9 2 2 4 3 2 4;}
@font-face
{font-family:"\@SimSun";
panose-1:2 1 6 0 3 1 1 1 1 1;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri","sans-serif";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
p.MsoListParagraph, li.MsoListParagraph, div.MsoListParagraph
{mso-style-priority:34;
margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:.5in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri","sans-serif";}
span.EmailStyle17
{mso-style-type:personal-compose;
font-family:"Calibri","sans-serif";
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;}
@page Section1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.Section1
{page:Section1;}
/* List Definitions */
@list l0
{mso-list-id:1257980232;
mso-list-type:hybrid;
mso-list-template-ids:-669767866 -1768291648 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l0:level1
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;
font-family:Symbol;
mso-fareast-font-family:SimSun;
mso-bidi-font-family:"Times New Roman";}
ol
{margin-bottom:0in;}
ul
{margin-bottom:0in;}
-->
</style>
<!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang=EN-US link=blue vlink=purple>
<div class=Section1>
<p class=MsoNormal>I’ve made some fixes since my previous release, so I’m
releasing an updated beta build. I’m very interested in any feedback you
may have about any part of this.<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal><a
href="http://www.280z28.org/downloads/antlr-dotnet-binaries-3.2.0.6288.7z">http://www.280z28.org/downloads/antlr-dotnet-binaries-3.2.0.6288.7z</a><o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Since this is hosted on a different site than the original,
you can check the assembly strong names to verify that I built this one with
the same in-house signing keys as the earlier release. :)<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Contents:<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoListParagraph style='text-indent:-.25in;mso-list:l0 level1 lfo1'><![if !supportLists]><span
style='font-family:Symbol'><span style='mso-list:Ignore'>·<span
style='font:7.0pt "Times New Roman"'>
</span></span></span><![endif]>LICENSE.txt. All code in the C# ports of the
Tool and StringTemplate, plus the CSharp3 target are licensed under the same
BSD 3-clause license as their Java counterparts <i>except for the addition of
my name</i>. Other targets are licensed under their own terms so you’ll
have to check those separately if they are relevant to you.<o:p></o:p></p>
<p class=MsoListParagraph style='text-indent:-.25in;mso-list:l0 level1 lfo1'><![if !supportLists]><span
style='font-family:Symbol'><span style='mso-list:Ignore'>·<span
style='font:7.0pt "Times New Roman"'>
</span></span></span><![endif]>CSharp3 runtime (Antlr3.Runtime.dll and
Antlr3.Runtime.Debug.dll). You always have to reference Antlr3.Runtime.dll to
use the CSharp3 target. You only need to reference Antlr3.Runtime.Debug.dll if
you build with the -debug or -profile command line flags.<o:p></o:p></p>
<p class=MsoListParagraph style='text-indent:-.25in;mso-list:l0 level1 lfo1'><![if !supportLists]><span
style='font-family:Symbol'><span style='mso-list:Ignore'>·<span
style='font:7.0pt "Times New Roman"'>
</span></span></span><![endif]>StringTemplate .NET port
(Antlr3.StringTemplate.dll). This depends on <i>both</i> of the CSharp3 runtime
DLL’s, so include those if you are using StringTemplate.<o:p></o:p></p>
<p class=MsoListParagraph style='text-indent:-.25in;mso-list:l0 level1 lfo1'><![if !supportLists]><span
style='font-family:Symbol'><span style='mso-list:Ignore'>·<span
style='font:7.0pt "Times New Roman"'>
</span></span></span><![endif]>ANTLR Tool .NET port (Antlr3.exe). Works with
the same command line arguments as the Java version, and should produce <i>nearly</i>
identical output for any given target. All target code generation templates are
updated to the latest version as of earlier today.<o:p></o:p></p>
<p class=MsoListParagraph style='text-indent:-.25in;mso-list:l0 level1 lfo1'><![if !supportLists]><span
style='font-family:Symbol'><span style='mso-list:Ignore'>·<span
style='font:7.0pt "Times New Roman"'>
</span></span></span><![endif]>MSBuild integration (Antlr3.targets,
AntlrBuildTask.dll). Preliminary instructions for using this follows.<o:p></o:p></p>
<p class=MsoListParagraph style='text-indent:-.25in;mso-list:l0 level1 lfo1'><![if !supportLists]><span
style='font-family:Symbol'><span style='mso-list:Ignore'>·<span
style='font:7.0pt "Times New Roman"'>
</span></span></span><![endif]>Symbol files for all binaries (*.pdb).<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>MSBuild Integration Instructions:<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>These instructions definitely work for Visual Studio 2008 C#
projects targeting the CSharp3 runtime (it’s how I built all the files
you’re downloading). They <i>almost surely</i> work for the CSharp2
target, but I haven’t tried it. They <i>might</i> also work for Visual
Studio 2005 or 2010 projects, but again I haven’t tried it.<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Extract the contents of the download to $(SolutionDir)\external\antlr.
For example, if you have the solution file C:\Something\MyProject.sln, then you
would find Antlr3.exe at C:\Something\external\antlr\tool\Antlr3.exe. (The
directions can be modified to suit if you want to use a different path.)<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Open your project file (*.csproj) as an XML or plain text
file and locate the line importing Microsoft.CSharp.targets. I’ve
included the line in the following block of code as a reference point for the necessary
changes – just add the other lines below that point.<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-size:8.0pt;
font-family:Consolas;color:blue'> <</span><span style='font-size:8.0pt;
font-family:Consolas;color:#A31515'>Import</span><span style='font-size:8.0pt;
font-family:Consolas;color:blue'> </span><span style='font-size:8.0pt;
font-family:Consolas;color:red'>Project</span><span style='font-size:8.0pt;
font-family:Consolas;color:blue'>=</span><span style='font-size:8.0pt;
font-family:Consolas'>"<span style='color:blue'>$(MSBuildToolsPath)\Microsoft.CSharp.targets</span>"<span
style='color:blue'> /><o:p></o:p></span></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-size:8.0pt;
font-family:Consolas;color:blue'> <!--</span><span style='font-size:
8.0pt;font-family:Consolas;color:green'> Include the following immediately
*after* the above import (which will already exist in the file) </span><span
style='font-size:8.0pt;font-family:Consolas;color:blue'>--><o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-size:8.0pt;
font-family:Consolas;color:blue'> <</span><span style='font-size:8.0pt;
font-family:Consolas;color:#A31515'>PropertyGroup</span><span style='font-size:
8.0pt;font-family:Consolas;color:blue'>><o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-size:8.0pt;
font-family:Consolas;color:blue'> <!--</span><span
style='font-size:8.0pt;font-family:Consolas;color:green'> Folder containing
AntlrBuildTask.dll </span><span style='font-size:8.0pt;font-family:Consolas;
color:blue'>--><o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-size:8.0pt;
font-family:Consolas;color:blue'> <</span><span
style='font-size:8.0pt;font-family:Consolas;color:#A31515'>AntlrBuildTaskPath</span><span
style='font-size:8.0pt;font-family:Consolas;color:blue'>></span><span
style='font-size:8.0pt;font-family:Consolas'>$(SolutionDir)external\antlr\msbuild<span
style='color:blue'></</span><span style='color:#A31515'>AntlrBuildTaskPath</span><span
style='color:blue'>><o:p></o:p></span></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-size:8.0pt;
font-family:Consolas;color:blue'> <!--</span><span
style='font-size:8.0pt;font-family:Consolas;color:green'> Path to the ANTLR
Tool itself. </span><span style='font-size:8.0pt;font-family:Consolas;
color:blue'>--><o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-size:8.0pt;
font-family:Consolas;color:blue'> <</span><span
style='font-size:8.0pt;font-family:Consolas;color:#A31515'>AntlrToolPath</span><span
style='font-size:8.0pt;font-family:Consolas;color:blue'>></span><span
style='font-size:8.0pt;font-family:Consolas'>$(SolutionDir)external\antlr\tool\Antlr3.exe<span
style='color:blue'></</span><span style='color:#A31515'>AntlrToolPath</span><span
style='color:blue'>><o:p></o:p></span></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-size:8.0pt;
font-family:Consolas;color:blue'> </</span><span style='font-size:
8.0pt;font-family:Consolas;color:#A31515'>PropertyGroup</span><span
style='font-size:8.0pt;font-family:Consolas;color:blue'>><o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-size:8.0pt;
font-family:Consolas;color:blue'> <</span><span style='font-size:8.0pt;
font-family:Consolas;color:#A31515'>Import</span><span style='font-size:8.0pt;
font-family:Consolas;color:blue'> </span><span style='font-size:8.0pt;
font-family:Consolas;color:red'>Project</span><span style='font-size:8.0pt;
font-family:Consolas;color:blue'>=</span><span style='font-size:8.0pt;
font-family:Consolas'>"<span style='color:blue'>$(SolutionDir)external\antlr\msbuild\Antlr3.targets</span>"<span
style='color:blue'> /><o:p></o:p></span></span></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>When you open the project in Visual Studio, you will be able
to select a .g or .g3 file in the project, select right click > Properties,
and choose Antlr3 as the Build Action. To add a new grammar to the project, add
a new “Text File” with the extension .g or .g3, and set its build
action. You no longer have to manually add grammars by editing the project
file.<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Finally, make sure you add a reference to the appropriate ANTLR
runtime (CSharp2 or CSharp3).<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Thank you,<o:p></o:p></p>
<p class=MsoNormal>Sam Harwell<o:p></o:p></p>
</div>
</body>
</html>