diff options
Diffstat (limited to 'ext/ripper/lib/ripper')
-rw-r--r-- | ext/ripper/lib/ripper/core.rb | 8 | ||||
-rw-r--r-- | ext/ripper/lib/ripper/filter.rb | 21 | ||||
-rw-r--r-- | ext/ripper/lib/ripper/lexer.rb | 17 | ||||
-rw-r--r-- | ext/ripper/lib/ripper/sexp.rb | 4 |
4 files changed, 30 insertions, 20 deletions
diff --git a/ext/ripper/lib/ripper/core.rb b/ext/ripper/lib/ripper/core.rb index 35aa54d090..637a72f4ad 100644 --- a/ext/ripper/lib/ripper/core.rb +++ b/ext/ripper/lib/ripper/core.rb @@ -12,8 +12,8 @@ require 'ripper.so' class Ripper - # Parses Ruby program read from _src_. - # _src_ must be a String or a IO or a object which has #gets method. + # Parses the given Ruby program read from +src+. + # +src+ must be a String or an IO or a object with a #gets method. def Ripper.parse(src, filename = '(ripper)', lineno = 1) new(src, filename, lineno).parse end @@ -42,12 +42,12 @@ class Ripper end # This method is called when weak warning is produced by the parser. - # _fmt_ and _args_ is printf style. + # +fmt+ and +args+ is printf style. def warn(fmt, *args) end # This method is called when strong warning is produced by the parser. - # _fmt_ and _args_ is printf style. + # +fmt+ and +args+ is printf style. def warning(fmt, *args) end diff --git a/ext/ripper/lib/ripper/filter.rb b/ext/ripper/lib/ripper/filter.rb index 898501b23c..239f9f00e1 100644 --- a/ext/ripper/lib/ripper/filter.rb +++ b/ext/ripper/lib/ripper/filter.rb @@ -13,9 +13,13 @@ require 'ripper/lexer' class Ripper # This class handles only scanner events, - # and they are dispatched in the `right' order (same with input). + # which are dispatched in the 'right' order (same with input). class Filter + # Creates a new Ripper::Filter instance, passes parameters +src+, + # +filename+, and +lineno+ to Ripper::Lexer.new + # + # The lexer is for internal use only. def initialize(src, filename = '-', lineno = 1) @__lexer = Lexer.new(src, filename, lineno) @__line = nil @@ -41,8 +45,9 @@ class Ripper @__col end - # Starts parsing. _init_ is a data accumulator. - # It is passed to the next event handler (as of Enumerable#inject). + # Starts the parser. + # +init+ is a data accumulator and is passed to the next event handler (as + # of Enumerable#inject). def parse(init = nil) data = init @__lexer.lex.each do |pos, event, tok| @@ -57,10 +62,12 @@ class Ripper private - # This method is called when some event handler have not defined. - # _event_ is :on_XXX, _token_ is scanned token, _data_ is a data - # accumulator. The return value of this method is passed to the - # next event handler (as of Enumerable#inject). + # This method is called when some event handler is undefined. + # +event+ is :on_XXX, +token+ is the scanned token, and +data+ is a data + # accumulator. + # + # The return value of this method is passed to the next event handler (as + # of Enumerable#inject). def on_default(event, token, data) data end diff --git a/ext/ripper/lib/ripper/lexer.rb b/ext/ripper/lib/ripper/lexer.rb index 5bbee39e06..b3b78ef1a1 100644 --- a/ext/ripper/lib/ripper/lexer.rb +++ b/ext/ripper/lib/ripper/lexer.rb @@ -12,13 +12,13 @@ require 'ripper/core' class Ripper - # Tokenizes Ruby program and returns an Array of String. + # Tokenizes the Ruby program and returns an Array of String. def Ripper.tokenize(src, filename = '-', lineno = 1) Lexer.new(src, filename, lineno).tokenize end - # Tokenizes Ruby program and returns an Array of Array, - # which is formatted like [[lineno, column], type, token]. + # Tokenizes the Ruby program and returns an Array of an Array, + # which is formatted like <code>[[lineno, column], type, token]</code>. # # require 'ripper' # require 'pp' @@ -90,9 +90,12 @@ class Ripper class TokenPattern #:nodoc: - class Error < ::StandardError; end - class CompileError < Error; end - class MatchError < Error; end + class Error < ::StandardError # :nodoc: + end + class CompileError < Error # :nodoc: + end + class MatchError < Error # :nodoc: + end class << self alias compile new @@ -155,7 +158,7 @@ class Ripper MAP[tok] or raise CompileError, "unknown token: #{tok}" end - class MatchData + class MatchData # :nodoc: def initialize(tokens, match) @tokens = tokens @match = match diff --git a/ext/ripper/lib/ripper/sexp.rb b/ext/ripper/lib/ripper/sexp.rb index 08bd152f18..66bd69134d 100644 --- a/ext/ripper/lib/ripper/sexp.rb +++ b/ext/ripper/lib/ripper/sexp.rb @@ -15,7 +15,7 @@ class Ripper # [EXPERIMENTAL] # Parses +src+ and create S-exp tree. # Returns more readable tree rather than Ripper.sexp_raw. - # This method is for mainly developer use. + # This method is mainly for developer use. # # require 'ripper' # require 'pp' @@ -33,7 +33,7 @@ class Ripper # [EXPERIMENTAL] # Parses +src+ and create S-exp tree. - # This method is for mainly developer use. + # This method is mainly for developer use. # # require 'ripper' # require 'pp' |