antlr3 1.6.0 → 1.6.3

data/History.txt

@@ -1,3 +1,11 @@
+=== 1.6.3 / 02-12-10
+
+* 4 Minor Enhancements
+  - added --help and --version options to antlr4ruby
+  - documented the antlr4ruby source and added license information
+  - prettied up the source code in all of the library files a little
+  - added a hoe-based rakefile with the gem distribution of the source code
+
 === 1.6.0 / 01-27-10
 
 * 4 Minor Enhancements to runtime library

data/Manifest.txt

@@ -0,0 +1,94 @@
+bin/antlr4ruby
+lib/antlr3/main.rb
+lib/antlr3/recognizers.rb
+lib/antlr3/modes/ast-builder.rb
+lib/antlr3/modes/filter.rb
+lib/antlr3/streams/rewrite.rb
+lib/antlr3/streams/interactive.rb
+lib/antlr3/debug.rb
+lib/antlr3/dot.rb
+lib/antlr3/streams.rb
+lib/antlr3/debug/record-event-listener.rb
+lib/antlr3/debug/rule-tracer.rb
+lib/antlr3/debug/socket.rb
+lib/antlr3/debug/trace-event-listener.rb
+lib/antlr3/debug/event-hub.rb
+lib/antlr3/version.rb
+lib/antlr3/error.rb
+lib/antlr3/tree.rb
+lib/antlr3/test/functional.rb
+lib/antlr3/test/call-stack.rb
+lib/antlr3/test/grammar.rb
+lib/antlr3/test/core-extensions.rb
+lib/antlr3/template.rb
+lib/antlr3/dfa.rb
+lib/antlr3/profile.rb
+lib/antlr3/template/parameter.rb
+lib/antlr3/template/group-lexer.rb
+lib/antlr3/template/group-parser.rb
+lib/antlr3/tree/visitor.rb
+lib/antlr3/tree/debug.rb
+lib/antlr3/tree/wizard.rb
+lib/antlr3/token.rb
+lib/antlr3/task.rb
+lib/antlr3/constants.rb
+lib/antlr3/util.rb
+lib/antlr3.rb
+test/unit/test-dfa.rb
+test/unit/sample-input/file-stream-1
+test/unit/sample-input/template-group
+test/unit/sample-input/teststreams.input2
+test/unit/test-tree-wizard.rb
+test/unit/test-streams.rb
+test/unit/test-recognizers.rb
+test/unit/test-trees.rb
+test/unit/test-exceptions.rb
+test/unit/test-scheme.rb
+test/unit/test-template.rb
+test/functional/delegation/import.rb
+test/functional/lexer/xml.rb
+test/functional/lexer/properties.rb
+test/functional/lexer/nuances.rb
+test/functional/lexer/basic.rb
+test/functional/lexer/filter-mode.rb
+test/functional/lexer/syn-pred.rb
+test/functional/debugging/rule-tracing.rb
+test/functional/debugging/profile-mode.rb
+test/functional/debugging/debug-mode.rb
+test/functional/ast-output/hetero-nodes.rb
+test/functional/ast-output/construction.rb
+test/functional/ast-output/rewrites.rb
+test/functional/ast-output/tree-rewrite.rb
+test/functional/ast-output/auto-ast.rb
+test/functional/main/main-scripts.rb
+test/functional/tree-parser/basic.rb
+test/functional/parser/predicates.rb
+test/functional/parser/backtracking.rb
+test/functional/parser/properties.rb
+test/functional/parser/nuances.rb
+test/functional/parser/rule-methods.rb
+test/functional/parser/basic.rb
+test/functional/parser/actions.rb
+test/functional/parser/calc.rb
+test/functional/parser/ll-star.rb
+test/functional/parser/scopes.rb
+test/functional/template-output/template-output.rb
+test/functional/token-rewrite/via-parser.rb
+test/functional/token-rewrite/basic.rb
+templates/ASTDbg.stg
+templates/AST.stg
+templates/Ruby.stg
+templates/ST.stg
+templates/Dbg.stg
+templates/ASTParser.stg
+templates/ASTTreeParser.stg
+samples/CPP.g
+samples/ANTLRv3Grammar.g
+README.txt
+ANTLR-LICENSE.txt
+History.txt
+Manifest.txt
+java/antlr-full-3.2.1.jar
+java/RubyTarget.java
+Manifest.txt
+Rakefile

data/README.txt

@@ -111,7 +111,7 @@ ANTLR provides for other language targets, such as Java and Python. It contains:
 == LICENSE
 
 [The "BSD licence"]
-Copyright (c) 2009 Kyle Yetter
+Copyright (c) 2009-2010 Kyle Yetter
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/Rakefile

@@ -0,0 +1,58 @@
+#!/usr/bin/ruby
+# encoding: utf-8
+
+require 'antlr3'
+require 'hoe'
+
+Hoe.spec "antlr3" do
+  self.version = ANTLR3::VERSION_STRING
+  self.rubyforge_name = "antlr3"
+  
+  developer "Kyle Yetter", "kcy5b@yahoo.com"
+  
+  spec_extras.update(
+    :required_ruby_version => ">= 1.8.7"
+  )
+  
+  self.test_globs = [
+    "test/unit/test-dfa.rb",
+    "test/unit/test-tree-wizard.rb",
+    "test/unit/test-streams.rb",
+    "test/unit/test-recognizers.rb",
+    "test/unit/test-trees.rb",
+    "test/unit/test-exceptions.rb",
+    "test/unit/test-scheme.rb",
+    "test/unit/test-template.rb",
+    "test/functional/delegation/import.rb",
+    "test/functional/lexer/xml.rb",
+    "test/functional/lexer/properties.rb",
+    "test/functional/lexer/nuances.rb",
+    "test/functional/lexer/basic.rb",
+    "test/functional/lexer/filter-mode.rb",
+    "test/functional/lexer/syn-pred.rb",
+    "test/functional/debugging/rule-tracing.rb",
+    "test/functional/debugging/profile-mode.rb",
+    "test/functional/debugging/debug-mode.rb",
+    "test/functional/ast-output/hetero-nodes.rb",
+    "test/functional/ast-output/construction.rb",
+    "test/functional/ast-output/rewrites.rb",
+    "test/functional/ast-output/tree-rewrite.rb",
+    "test/functional/ast-output/auto-ast.rb",
+    "test/functional/main/main-scripts.rb",
+    "test/functional/tree-parser/basic.rb",
+    "test/functional/parser/predicates.rb",
+    "test/functional/parser/backtracking.rb",
+    "test/functional/parser/properties.rb",
+    "test/functional/parser/nuances.rb",
+    "test/functional/parser/rule-methods.rb",
+    "test/functional/parser/basic.rb",
+    "test/functional/parser/actions.rb",
+    "test/functional/parser/calc.rb",
+    "test/functional/parser/ll-star.rb",
+    "test/functional/parser/scopes.rb",
+    "test/functional/template-output/template-output.rb",
+    "test/functional/token-rewrite/via-parser.rb",
+    "test/functional/token-rewrite/basic.rb"
+  ]
+  
+end

data/bin/antlr4ruby

@@ -1,12 +1,106 @@
-#!/usr/bin/ruby
+#!/usr/bin/env ruby
 # encoding: utf-8
 
-__DIR__ = File.expand_path( File.dirname __FILE__ )
-project_top = File.dirname __DIR__
-lib = File.join( project_top, 'lib' )
-$:.unshift( lib )
-require 'antlr3'
+=begin LICENSE
+
+[The "BSD licence"]
+Copyright (c) 2009 Kyle Yetter
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+ 1. Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+ 3. The name of the author may not be used to endorse or promote products
+    derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+=end
+
+=begin rdoc antlr4ruby
+
+A simple wrapper script to run the ANTLR tool with the ruby antlr3
+target modifications in place of the default Ruby target data.
+It essentially does two things:
+
+* locate the `customized' ANTLR v.3 JAR archive file
+* exec the command <tt>java -cp path/to/jar $ARGV</tt>
+
+Thus, for ANTLR tool usage, refer to ANTLR's main documentation
+at http://www.antlr.org .
+
+There are a small number of additional options available
+in addition to ANTLR's options:
+
+  --version         display the Ruby target version and then the
+                    ANTLR tool's version information
+  
+  --help, -h        as ANTLR does not provide these standard switches,
+                    it executes the ANTLR tool without arguments to make
+                    it print out usage information
+                    
+  --keep-classpath  Do not unset the CLASSPATH environmental variable before
+                    executing the java command (*)
+
+
+(*) This script unsets CLASSPATH to avoid interference from system installations
+    of prior versions of ANTLR. The jar that is distributed with this package
+    is complete, and thus does not generally require any external libraries, so
+    this shouldn't cause any major problems. However, if for some reason you
+    need to keep this variable to execute the command properly, you can use
+    the --keep-classpath option.
+=end
+
+$0 = 'antlr4ruby'
+
+begin
+  require 'antlr3'
+rescue LoadError
+  __DIR__ = File.expand_path( File.dirname __FILE__ )
+  project_top = File.dirname __DIR__
+  lib = File.join( project_top, 'lib' )
+  $LOAD_PATH.unshift( lib )
+  require 'antlr3'
+end
 
 jar = ANTLR3.antlr_jar or fail( "cannot find antlr4ruby's customized ANTLR jar" )
 
-exec( 'java', '-jar', jar, *ARGV )
+run = proc do | *args |
+  exec( 'java', '-jar', jar, *args )
+end
+
+ARGV.delete( '--keep-classpath' ) or
+  ENV.delete( 'CLASSPATH' )
+
+if ARGV.include?( '--version' )
+  
+  puts( "Ruby Target and Runtime Library Version: #{ ANTLR3::VERSION_STRING }" )
+  run.call( '-version' )
+  
+elsif ARGV.include?( '--help' ) or ARGV.include?( '-h' )
+  
+  # the ANTLR tool doesn't follow the --help/-h convention
+  # -- it provides help only if no arguments are specified
+  run.call
+  
+else
+  
+  # run the tool
+  run.call( *ARGV )
+  
+end

data/lib/antlr3.rb

@@ -4,7 +4,7 @@
 =begin LICENSE
 
 [The "BSD licence"]
-Copyright (c) 2009 Kyle Yetter
+Copyright (c) 2009-2010 Kyle Yetter
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
@@ -93,10 +93,13 @@ antlr3/dot.rb::
   extra utilities to generate DOT map specifications for graphical.
   representations of ASTs
 
+@author Kyle Yetter
+
 =end
 
 module ANTLR3
-
+  
+  # :stopdoc:
   LIBRARY_PATH  = ::File.expand_path(::File.dirname(__FILE__))
   # :startdoc:
   
@@ -126,8 +129,27 @@ module ANTLR3
     raise(bug)
   end
   
+  @antlr_jar = nil
+  
+  def self.antlr_jar=( path )
+    @antlr_jar = path ? File.expand_path( path.to_s ) : path
+  end
+  
   def self.antlr_jar
-    path = project_path "java/antlr-full-#{ANTLR_VERSION_STRING}.jar"
+    @antlr_jar and return( @antlr_jar )
+    
+    path = project_path "java/antlr-full-#{ ANTLR_VERSION_STRING }.jar"
+    if env_path = ENV[ 'RUBY_ANTLR_JAR' ]
+      if File.file?( env_path ) then return File.expand_path( env_path ) end
+      
+      warn(
+        "#{ __FILE__ }:#{ __LINE__ }: " <<
+        "ignoring environmental variable RUBY_ANTLR_JAR (=%p) " % env_path <<
+        "as it is not the path to an existing file\n" <<
+        "  -> trying default jar path %p instead" % path
+      )
+    end
+    
     File.exists?( path ) ? path : nil
   end
   
@@ -138,6 +160,8 @@ module ANTLR3
   # Tree classes are only used by tree parsers or AST-building parsers
   # Thus, they're not essential for everything ANTLR generates and
   # are autoloaded on-demand
+  autoload :AST, 'antlr3/tree'
+  
   tree_classes = [
     :Tree, :TreeAdaptor, :BaseTree, :BaseTreeAdaptor,
     :CommonTree, :CommonErrorNode, :CommonTreeAdaptor,
@@ -146,7 +170,7 @@ module ANTLR3
     :RewriteRuleTokenStream, :RewriteRuleSubtreeStream,
     :RewriteRuleNodeStream
   ]
-  autoload :AST, 'antlr3/tree'
+  
   for klass in tree_classes
     autoload klass, 'antlr3/tree'
   end
@@ -167,12 +191,16 @@ module ANTLR3
   
 end  # module ANTLR3
 
+
 require 'set'
 require 'antlr3/util'
 require 'antlr3/version'
-require 'antlr3/constants'
-require 'antlr3/error'
-require 'antlr3/token'
-require 'antlr3/recognizers'
-require 'antlr3/dfa'
-require 'antlr3/streams'
+
+unless $0 == 'antlr4ruby'
+  require 'antlr3/constants'
+  require 'antlr3/error'
+  require 'antlr3/token'
+  require 'antlr3/recognizers'
+  require 'antlr3/dfa'
+  require 'antlr3/streams'
+end

data/lib/antlr3/constants.rb

@@ -4,7 +4,7 @@
 =begin LICENSE
 
 [The "BSD licence"]
-Copyright (c) 2009 Kyle Yetter
+Copyright (c) 2009-2010 Kyle Yetter
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
@@ -45,18 +45,26 @@ module Constants
   # built-in token channel IDs
   
   # the channel to which most tokens will be assigned
-  DEFAULT = DEFAULT_CHANNEL = :default
+  DEFAULT = DEFAULT_CHANNEL = DEFAULT_TOKEN_CHANNEL = :default
   
   # the channel for tokens which should not be passed to a parser by a token stream
   HIDDEN  = HIDDEN_CHANNEL  = :hidden
   
+  # flag used by recognizers during memoization to
+  # represent a previous prediction failure
+  MEMO_RULE_FAILED = -2
+  
+  # flag used by recognizers during memoization to indicate
+  # that the rule has not been memoized yet
+  MEMO_RULE_UNKNOWN = -1
+  
   # built-in token types used internally by ANTLR3
   
   INVALID_TOKEN_TYPE = 0
   
-  # End of File / End of Input character and token type
   EOF = -1
   
+  
   # Imaginary tree-navigation token type indicating the ascent after moving through the
   # children of a node
   UP = 3
@@ -74,10 +82,10 @@ module Constants
   # returning a string "<UNKNOWN: #{type}>" for non-builtin token
   # types
   BUILT_IN_TOKEN_NAMES = Hash.new do |h, k|
-    "<UNKNOWN: #{k}>"
+    "<UNKNOWN: #{ k }>"
   end
   
-  BUILT_IN_TOKEN_NAMES.update(
+  BUILT_IN_TOKEN_NAMES.update( 
     0 => "<invalid>".freeze, 1 => "<EOR>".freeze, 
     2 => "<DOWN>".freeze, 3 => "<UP>".freeze, 
     -1 => "<EOF>".freeze

data/lib/antlr3/debug.rb

@@ -4,7 +4,7 @@
 =begin LICENSE
 
 [The "BSD licence"]
-Copyright (c) 2009 Kyle Yetter
+Copyright (c) 2009-2010 Kyle Yetter
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
@@ -58,7 +58,7 @@ autoload :EventHub, 'antlr3/debug/event-hub'
 autoload :TreeAdaptor, 'antlr3/tree/debug'
 autoload :TreeNodeStream, 'antlr3/tree/debug'
 
-RecognizerSharedState = Struct.new(
+RecognizerSharedState = Struct.new( 
   # the rule invocation depth
   :rule_invocation_stack,
   # a boolean flag to indicate whether or not the current decision is cyclic
@@ -101,7 +101,7 @@ generated in debug or profiling mode.
 =end
 class RecognizerSharedState
   def initialize
-    super([], false, [], false, -1, 0, nil, 0, nil, -1)
+    super( [], false, [], false, -1, 0, nil, 0, nil, -1 )
     # ^-- same as this --v 
     # self.following = []
     # self.error_recovery = false
@@ -141,9 +141,9 @@ switch.
 module ParserEvents
   include ANTLR3::Error
   
-  def self.included(klass)
+  def self.included( klass )
     super
-    if klass.is_a?(::Class)
+    if klass.is_a?( ::Class )
       def klass.debug?
         true
       end
@@ -153,16 +153,16 @@ module ParserEvents
   
   attr_reader :debug_listener
   
-  def initialize(stream, options = {})
-    @debug_listener = options[:debug_listener] ||= begin
+  def initialize( stream, options = {} )
+    @debug_listener = options[ :debug_listener ] ||= begin
       EventSocketProxy.new( self, options ).handshake
     end
-    options[:state] ||= Debug::RecognizerSharedState.new
-    super(stream, options)
-    if @input.is_a?(Debug::TokenStream)
+    options[ :state ] ||= Debug::RecognizerSharedState.new
+    super( stream, options )
+    if @input.is_a?( Debug::TokenStream )
       @input.debug_listener ||= @debug_listener
     else
-      @input = Debug::TokenStream.wrap(@input, @debug_listener)
+      @input = Debug::TokenStream.wrap( @input, @debug_listener )
     end
   end
   
@@ -174,14 +174,14 @@ module ParserEvents
     @state.cyclic_decision
   end
   
-  def cyclic_decision=(flag)
+  def cyclic_decision=( flag )
     @state.cyclic_decision = flag
   end
   
   # custom attribute writer for debug_listener
   # propegates the change in listener to the
   # parser's debugging input stream
-  def debug_listener=(dbg)
+  def debug_listener=( dbg )
     @debug_listener = dbg
     @input.debug_listener = dbg rescue nil
   end
@@ -199,22 +199,22 @@ module ParserEvents
   # TO-DO: is this pointless?
   def resync
     begin_resync
-    yield(self)
+    yield( self )
   ensure
     end_resync
   end
   
   def begin_backtrack
-    @debug_listener.begin_backtrack(@state.backtracking)
+    @debug_listener.begin_backtrack( @state.backtracking )
   end
   
-  def end_backtrack(successful)
-    @debug_listener.end_backtrack(@state.backtracking, successful)
+  def end_backtrack( successful )
+    @debug_listener.end_backtrack( @state.backtracking, successful )
   end
   
   def backtrack
     @state.backtracking += 1
-    @debug_listener.begin_backtrack(@state.backtracking)
+    @debug_listener.begin_backtrack( @state.backtracking )
     start = @input.mark
     success =
       begin yield
@@ -223,8 +223,8 @@ module ParserEvents
       end
     return success
   ensure
-    @input.rewind(start)
-    @debug_listener.end_backtrack(@state.backtracking, (success rescue nil))
+    @input.rewind( start )
+    @debug_listener.end_backtrack( @state.backtracking, ( success rescue nil ) )
     @state.backtracking -= 1
   end
   
@@ -240,43 +240,43 @@ module ParserEvents
     return( symbol )
   end
   
-  def in_rule(grammar_file, rule_name)
+  def in_rule( grammar_file, rule_name )
     @state.rule_invocation_stack.empty? and @debug_listener.commence
-    @debug_listener.enter_rule(grammar_file, rule_name)
-    @state.rule_invocation_stack.push(grammar_file, rule_name)
+    @debug_listener.enter_rule( grammar_file, rule_name )
+    @state.rule_invocation_stack.push( grammar_file, rule_name )
     yield
   ensure
-    @state.rule_invocation_stack.pop(2)
-    @debug_listener.exit_rule(grammar_file, rule_name)
+    @state.rule_invocation_stack.pop( 2 )
+    @debug_listener.exit_rule( grammar_file, rule_name )
     @state.rule_invocation_stack.empty? and @debug_listener.terminate
   end
   
   def rule_invocation_stack
-    @state.rule_invocation_stack.each_slice(2).to_a
+    @state.rule_invocation_stack.each_slice( 2 ).to_a
   end
   
-  def predicate?(description)
+  def predicate?( description )
     result = yield
-    @debug_listener.semantic_predicate(result, description)
+    @debug_listener.semantic_predicate( result, description )
     return result
   end
   
-  def in_alternative(alt_number)
-    @debug_listener.enter_alternative(alt_number)
+  def in_alternative( alt_number )
+    @debug_listener.enter_alternative( alt_number )
   end
   
-  def in_subrule(decision_number)
-    @debug_listener.enter_subrule(decision_number)
+  def in_subrule( decision_number )
+    @debug_listener.enter_subrule( decision_number )
     yield
   ensure
-    @debug_listener.exit_subrule(decision_number)
+    @debug_listener.exit_subrule( decision_number )
   end
   
-  def in_decision(decision_number)
-    @debug_listener.enter_decision(decision_number)
+  def in_decision( decision_number )
+    @debug_listener.enter_decision( decision_number )
     yield
   ensure
-    @debug_listener.exit_decision(decision_number)
+    @debug_listener.exit_decision( decision_number )
   end
 end
 
@@ -290,14 +290,14 @@ not already a Debug::TokenStream.
 =end
 module TokenStream
   
-  def self.wrap(stream, debug_listener = nil)
-    stream.extend(self)
+  def self.wrap( stream, debug_listener = nil )
+    stream.extend( self )
     stream.instance_eval do
       @initial_stream_state = true
       @debug_listener = debug_listener
       @last_marker = nil
     end
-    return(stream)
+    return( stream )
   end
   attr_reader :last_marker
   attr_accessor :debug_listener
@@ -307,11 +307,11 @@ module TokenStream
     a = index + 1 # the next position IF there are no hidden tokens in between
     t = super
     b = index     # the actual position after consuming
-    @debug_listener.consume_token(t) if @debug_listener
+    @debug_listener.consume_token( t ) if @debug_listener
     
     # if b > a, report the consumption of hidden tokens
     for i in a...b
-      @debug_listener.consume_hidden_token at(i)
+      @debug_listener.consume_hidden_token at( i )
     end
   end
   
@@ -330,7 +330,7 @@ module TokenStream
   def consume_initial_hidden_tokens
     first_on_channel_token_index = self.index
     first_on_channel_token_index.times do |index|
-      @debug_listener.consume_hidden_token at(index)
+      @debug_listener.consume_hidden_token at( index )
     end
     @initial_stream_state = false
   end
@@ -341,20 +341,20 @@ module TokenStream
   ###################################### Stream Methods ######################################
   ############################################################################################
   
-  def look(steps = 1)
+  def look( steps = 1 )
     @initial_stream_state and consume_initial_hidden_tokens
-    token = super(steps)
-    @debug_listener.look(steps, token)
+    token = super( steps )
+    @debug_listener.look( steps, token )
     return token
   end
   
-  def peek(steps = 1)
-    look(steps).type
+  def peek( steps = 1 )
+    look( steps ).type
   end
   
   def mark
     @last_marker = super
-    @debug_listener.mark(@last_marker)
+    @debug_listener.mark( @last_marker )
     return @last_marker
   end
   
@@ -379,14 +379,14 @@ module EventListener
   # The grammarFileName allows composite grammars to jump around among
   # multiple grammar files.
   
-  def enter_rule(grammar_file, rule_name)
+  def enter_rule( grammar_file, rule_name )
     # do nothing
   end
   
   # Because rules can have lots of alternatives, it is very useful to
   # know which alt you are entering.  This is 1..n for n alts.
   
-  def enter_alternative(alt)
+  def enter_alternative( alt )
     # do nothing
   end
   
@@ -397,7 +397,7 @@ module EventListener
   # The grammarFileName allows composite grammars to jump around among
   # multiple grammar files.
   
-  def exit_rule(grammar_file, rule_name)
+  def exit_rule( grammar_file, rule_name )
     # do nothing
   end
 
@@ -476,7 +476,7 @@ module EventListener
   
   def backtrack( level )
     begin_backtrack( level )
-    successful = yield(self)
+    successful = yield( self )
     end_backtrack( level, successful )
   end
 
@@ -567,7 +567,7 @@ module EventListener
   
   def resync
     begin_resync
-    yield(self)
+    yield( self )
     end_resync
   end
 
@@ -670,16 +670,16 @@ module EventListener
     # do nothing
   end
   
-  def examine_rule_memoization(rule)
+  def examine_rule_memoization( rule )
     # do nothing
   end
   
-  def on(event_name, &block)
+  def on( event_name, &block )
     sclass = class << self; self; end
-    sclass.send(:define_method, event_name, &block)
+    sclass.send( :define_method, event_name, &block )
   end
   
-  EVENTS = [
+  EVENTS = [ 
     :add_child, :backtrack, :become_root, :begin_backtrack,
     :begin_resync, :commence, :consume_hidden_token,
     :consume_node, :consume_token, :create_node, :end_backtrack,