title: How do I get ANTLRWorks working?
body: <p>By following <a href="http://www.antlr.org/wiki/pages/viewpage.action?pageId=728" rel="nofollow">How do I install this damn thing? on</a> www.antlr.org I have got ANTLR 3.5 to work:</p>
  
  <pre><code>$ java -version    # I have Oracle`s Java JDK installed
  java version "1.7.0_11"
  Java(TM) SE Runtime Environment (build 1.7.0_11-b21)
  Java HotSpot(TM) 64-Bit Server VM (build 23.6-b04, mixed mode)
  $ ls
  antlrworks-1.5.jar
  $ export CLASSPATH=./antlrworks-1.5.jar:$CLASSPATH
  $ java org.antlr.Tool -version
  ANTLR Parser Generator  Version 3.5
  </code></pre>
  
  <p>But according to <a href="http://www.antlr.org/works/" rel="nofollow">ANTLRWorks: The ANTLR GUI Development Environment</a>, <strong>ANTLRWorks should also be included in the above JAR file. How do I start it?</strong></p>
  
  <hr>
  
  <p>If I type <code>java a</code> and double tab it first completes it to <code>java antlr.</code> indicating that there is no antlrworks package on the classpath. I don't know if there should be one. If I keep double tabbing I get:</p>
  
  <pre><code>antlr.ANTLRException                     antlr.CharStreamIOException              antlr.debug.ListenerBase                 antlr.debug.TraceListener                antlr.SemanticException
  antlr.ANTLRHashString                    antlr.collections.AST                    antlr.debug.MessageEvent                 antlr.DefaultFileLineFormatter           antlr.StringUtils
  antlr.ANTLRStringBuffer                  antlr.collections.ASTEnumeration         antlr.debug.MessageListener              antlr.FileLineFormatter                  antlr.Token
  antlr.ASTFactory                         antlr.collections.impl.ASTArray          antlr.debug.ParserListener               antlr.InputBuffer                        antlr.TokenBuffer
  antlr.ASTNULLType                        antlr.collections.impl.ASTEnumerator     antlr.debug.ParserMatchEvent             antlr.LexerSharedInputState              antlr.TokenQueue
  antlr.ASTPair                            antlr.collections.impl.BitSet            antlr.debug.ParserMatchListener          antlr.LLkParser                          antlr.TokenStream
  antlr.BaseAST                            antlr.collections.impl.IntRange          antlr.debug.ParserTokenEvent             antlr.MismatchedCharException            antlr.TokenStreamException
  antlr.ByteBuffer                         antlr.collections.impl.Vector            antlr.debug.ParserTokenListener          antlr.MismatchedTokenException           antlr.TokenStreamIOException
  antlr.CharBuffer                         antlr.collections.impl.VectorEnumerator  antlr.debug.SemanticPredicateEvent       antlr.NoViableAltException               antlr.TokenStreamRecognitionException
  antlr.CharFormatter                      antlr.CommonAST                          antlr.debug.SemanticPredicateListener    antlr.NoViableAltForCharException        antlr.TreeParser
  antlr.CharQueue                          antlr.CommonToken                        antlr.debug.SyntacticPredicateEvent      antlr.Parser                             antlr.TreeParserSharedInputState
  antlr.CharScanner                        antlr.debug.Event                        antlr.debug.SyntacticPredicateListener   antlr.ParserSharedInputState             antlr.Utils
  antlr.CharStreamException                antlr.debug.GuessingEvent                antlr.debug.TraceEvent                   antlr.RecognitionException               
  </code></pre>
  
  <hr>
  
  <p>I downloaded <code>antlrworks-1.5.jar</code> by visiting <a href="http://www.antlr.org/download.html" rel="nofollow">http://www.antlr.org/download.html</a> and clicking <a href="http://www.antlr.org/download/antlrworks-1.5.jar" rel="nofollow">Version 1.5 - for Windows, Linux and Mac OS X</a>. The JAR's file size is <code>2684608</code> bytes.</p>