cucumber 0.3.96 → 0.3.97

data/History.txt

@@ -1,6 +1,25 @@
+== 0.3.97 2009-08-23
+
+The AA-FTT release. Creating a release for the AA-FTT meeting in Chicago so that we can play
+with the new language API and maybe knock out some better .NET support.
+
+=== Bugfixes
+* Allow comments on examples sections underneath scenario outlines (#420 Mike Sassak)
+* Table.map_headers! will fail with a decent error message when 0 or 2+ headers are matched. (Aslak Hellesøy)
+* Fixed an issue with comments with preceding spaces after a background causing a parse error (#401 Joseph Wilk)
+
+=== New Features
+* The public API is documented and there is a new :sdoc task to generate nice searchable API docs.
+* Add :default => :cucumber when setting up Rake tasks for Cucumber in Rails (Aslak Hellesøy)
+* New When /^I fill in "([^\"]*)" for "([^\"]*)"$/ Webrat step for Rails (Aslak Hellesøy)
+
+=== Changed Features
+* Changed the Programming Language API to support languages without "bleed through" (e.g. rubypython can't invoke ruby objs) (Aslak Hellesøy)
+* The Programming Language API manages hooks on the language level instead of on the step mother level (Aslak Hellesøy)
+
 == 0.3.96 2009-08-15
 
-This release doesn't have any directly visible new features or bug fixes. But there are big
+This release doesn't have any significant new features or bug fixes, but there are big
 internal changes. This release has a new API for plugging in other programming languages.
 You can read more about that here: http://groups.google.com/group/cukes/browse_thread/thread/b9db8bf1f3ec9708
 
@@ -870,8 +889,8 @@ spaces removed too.
 == 0.1.8 2008-10-18
 
 This release extends the support for tables. PLEASE NOTE THAT TABLES ARE STILL EXPERIMENTAL.
-In previous releases it has been possible to use tables to define "more examples" of a scenario i
-n a FIT-style column fixture kind of way. Now you can also use tables as arguments to steps.
+In previous releases it has been possible to use tables to define "more examples" of a scenario in 
+a FIT-style column fixture kind of way. Now you can also use tables as arguments to steps.
 
 Tables used to define more examples after a scenario must now be prefixed. In English it looks like this:
 

data/License.txt

@@ -1,3 +1,5 @@
+The MIT License
+
 Copyright (c) 2008,2009 Aslak Hellesøy
 
 Permission is hereby granted, free of charge, to any person obtaining

data/Manifest.txt

@@ -168,6 +168,7 @@ examples/junit/features/pending.feature
 examples/junit/features/step_definitions/steps.rb
 examples/pure_java/README.textile
 examples/python/features/fibonacci.feature
+examples/python/features/step_definitions/fib_steps.py
 examples/python/features/step_definitions/fib_steps.rb
 examples/python/features/support/env.rb
 examples/python/lib/fib.py
@@ -289,7 +290,8 @@ gem_tasks/flog.rake
 gem_tasks/gemspec.rake
 gem_tasks/rspec.rake
 gem_tasks/sass.rake
-gem_tasks/yard.rake
+gem_tasks/sdoc.rake
+lib/README.rdoc
 lib/autotest/cucumber.rb
 lib/autotest/cucumber_mixin.rb
 lib/autotest/cucumber_rails.rb
@@ -346,7 +348,7 @@ lib/cucumber/formatter/tag_cloud.rb
 lib/cucumber/formatter/unicode.rb
 lib/cucumber/formatter/usage.rb
 lib/cucumber/formatters/unicode.rb
-lib/cucumber/language_support/hook_methods.rb
+lib/cucumber/language_support.rb
 lib/cucumber/language_support/language_methods.rb
 lib/cucumber/language_support/step_definition_methods.rb
 lib/cucumber/languages.yml
@@ -359,6 +361,9 @@ lib/cucumber/parser/table.rb
 lib/cucumber/parser/table.tt
 lib/cucumber/parser/treetop_ext.rb
 lib/cucumber/platform.rb
+lib/cucumber/py_support/py_dsl.py
+lib/cucumber/py_support/py_language.py
+lib/cucumber/py_support/py_language.rb
 lib/cucumber/rails/rspec.rb
 lib/cucumber/rails/world.rb
 lib/cucumber/rake/task.rb
@@ -366,13 +371,13 @@ lib/cucumber/rb_support/rb_dsl.rb
 lib/cucumber/rb_support/rb_hook.rb
 lib/cucumber/rb_support/rb_language.rb
 lib/cucumber/rb_support/rb_step_definition.rb
+lib/cucumber/rb_support/rb_world.rb
 lib/cucumber/rspec_neuter.rb
 lib/cucumber/step_match.rb
 lib/cucumber/step_mother.rb
 lib/cucumber/version.rb
 lib/cucumber/webrat/element_locator.rb
 lib/cucumber/webrat/table_locator.rb
-lib/cucumber/world.rb
 rails_generators/cucumber/USAGE
 rails_generators/cucumber/cucumber_generator.rb
 rails_generators/cucumber/templates/cucumber
@@ -396,7 +401,6 @@ spec/cucumber/ast/scenario_spec.rb
 spec/cucumber/ast/step_collection_spec.rb
 spec/cucumber/ast/step_spec.rb
 spec/cucumber/ast/table_spec.rb
-spec/cucumber/ast/visitor_spec.rb
 spec/cucumber/broadcaster_spec.rb
 spec/cucumber/cli/configuration_spec.rb
 spec/cucumber/cli/drb_client_spec.rb
@@ -415,8 +419,8 @@ spec/cucumber/parser/table_parser_spec.rb
 spec/cucumber/rails/stubs/mini_rails.rb
 spec/cucumber/rails/stubs/test_help.rb
 spec/cucumber/rails/world_spec.rb
+spec/cucumber/rb_support/rb_step_definition_spec.rb
 spec/cucumber/sell_cucumbers.feature
-spec/cucumber/step_definition_spec.rb
 spec/cucumber/step_mother_spec.rb
 spec/cucumber/treetop_parser/empty_feature.feature
 spec/cucumber/treetop_parser/empty_scenario.feature

data/config/hoe.rb

@@ -63,6 +63,7 @@ $hoe = Hoe.spec(GEM_NAME) do |p|
   p.extra_deps = [ 
     ['term-ansicolor', '>= 1.0.3'], 
     ['treetop', '>= 1.3.0'], 
+    ['polyglot', '>= 0.2.8'], # Don't really want polyglot, but it keeps breaking so we'll make people use something that works ok'ish 
     ['diff-lcs', '>= 1.1.2'],
     ['builder', '>= 2.1.2']
   ]

data/examples/i18n/Rakefile

@@ -6,7 +6,7 @@ task :i18n do
       lang = f[dir.length+1..-1]
       if examples_working?(lang)
         Dir.chdir(f) do
-          rake("features")
+          rake("cucumber")
         end
       else
         STDERR.puts %{
@@ -21,10 +21,12 @@ task :i18n do
   end
 end
 
+task :default => :i18n
+
 def examples_working?(lang)
-  !%w{ro ko li lt}.index(lang)
+  !%w{ro}.index(lang)
 end
 
 def rake(args)
-  ruby($0, args) rescue nil
+  ruby($0, args)
 end

data/examples/i18n/fi/features/yhteenlasku.feature

@@ -1,13 +1,14 @@
+# language: fi
 Ominaisuus: Yhteenlasku
   Välttyäkseni hölmöiltä virheiltä
   Koska olen laskutaidoton
   Haluan että yhteenlaskut lasketaan puolestani
 
   Tapausaihio: Kahden luvun summa
-    Oletetaan että olen syöttänyt laskimeen luvun 50
-    Ja että olen syöttänyt laskimeen luvun 70
-    Kun painan "summaa"
-    Niin laskimen ruudulla pitäisi näkyä tulos 120
+    Oletetaan että olen syöttänyt laskimeen luvun <luku_1>
+    Ja että olen syöttänyt laskimeen luvun <luku_2>
+    Kun painan "<nappi>"
+    Niin laskimen ruudulla pitäisi näkyä tulos <tulos>
 
   Tapaukset:
     | luku_1  | luku_2  | nappi  | tulos  |

data/examples/python/features/step_definitions/fib_steps.py

@@ -0,0 +1,3 @@
+from py_dsl import *
+
+Given("Hello from python")

data/examples/python/features/support/env.rb

@@ -1,21 +1,21 @@
-require 'rubypython'
-
-ENV['PYTHONPATH'] = File.expand_path(File.dirname(__FILE__) + '/../../lib')
-
-Before do
-  RubyPython.start
-  @fib = RubyPython.import('fib')
-end
-
-After do
-  RubyPython.stop
-end
-
-# RubyPython seems to expect this to exist (?)
-class String
-  def end_with?(str)
-    str = str.to_str
-    tail = self[-str.length, str.length]
-    tail == str      
-  end
-end
+# require 'rubypython'
+# 
+# ENV['PYTHONPATH'] = File.expand_path(File.dirname(__FILE__) + '/../../lib')
+# 
+# Before do
+#   RubyPython.start
+#   @fib = RubyPython.import('fib')
+# end
+# 
+# After do
+#   RubyPython.stop
+# end
+# 
+# # RubyPython seems to expect this to exist (?)
+# class String
+#   def end_with?(str)
+#     str = str.to_str
+#     tail = self[-str.length, str.length]
+#     tail == str      
+#   end
+# end

data/gem_tasks/contributors.rake

@@ -1,4 +1,12 @@
 task :contributors do
   contributors = `git log --pretty=short --no-merges | git shortlog -ne | egrep -ve '^ +' | egrep -ve '^$'`
   puts contributors.split("\n").length
+end
+
+task :codeswarm do
+  sh "code_swarm --reload" rescue nil # Fails because of encoding - which we'll fix
+  sh "iconv -f latin1 -t utf-8 .git/.code_swarm/log.xml > tmp.xml && mv tmp.xml .git/.code_swarm/log.xml"
+  sh "sed -e 's/Aslak\ Hellesøy@.BEKK.no/aslak.hellesoy@gmail.com/g' .git/.code_swarm/log.xml > tmp.xml && mv tmp.xml .git/.code_swarm/log.xml"
+  sh "sed -e 's/josephwilk@joesniff.co.uk/joe@josephwilk.net/g' .git/.code_swarm/log.xml > tmp.xml && mv tmp.xml .git/.code_swarm/log.xml"
+  sh "code_swarm"
 end

data/gem_tasks/features.rake

@@ -3,6 +3,7 @@ require 'cucumber/rake/task'
 
 Cucumber::Rake::Task.new do |t|
   t.cucumber_opts = %w{--format progress}
+  t.rcov = ENV['RCOV']
 end
 
 Cucumber::Rake::Task.new('pretty') do |t|

data/gem_tasks/sdoc.rake

@@ -0,0 +1,7 @@
+require 'sdoc' # and use your RDoc task the same way you used it before
+
+Rake::RDocTask.new(:sdoc) do |rdoc|
+  rdoc.rdoc_dir = 'doc/sdoc'
+  rdoc.options += %w{--fmt shtml -N --webcvs=http://github.com/aslakhellesoy/cucumber/blob/v0.3.96/%s --title "Cucumber API" --threads 4 --main README --exclude cucumber/parser lib}
+  rdoc.template = 'direct' # lighter template used on railsapi.com
+end

data/lib/README.rdoc

@@ -0,0 +1,12 @@
+= Cucumber API
+
+This is the public API of Cucumber. The public API includes the classes, modules
+and methods you can use if you are a user of Cucumber. It also applies to you if
+you're developing a 3rd party tool that integrates with Cucumber.
+
+== Internal API
+
+Cucumber has more classes, modules and methods than what you can see in the public
+API. If you decide to dive into the source code and make use of an API that isn't
+part of this documentation - beware that this API might change at any time. If you
+want a particular internal API to be promoted to the public API - let us know.

data/lib/cucumber/ast/background.rb

@@ -2,7 +2,7 @@ require 'cucumber/ast/feature_element'
 
 module Cucumber
   module Ast
-    class Background
+    class Background #:nodoc:
       include FeatureElement
       attr_reader :feature_elements
 

data/lib/cucumber/ast/comment.rb

@@ -7,7 +7,7 @@ module Cucumber
     #
     # This gets parsed into a Comment with value <tt>"# Lorem ipsum\n# dolor sit amet\n"</tt>
     #
-    class Comment
+    class Comment #:nodoc:
       def initialize(value)
         @value = value
       end

data/lib/cucumber/ast/examples.rb

@@ -1,12 +1,13 @@
 module Cucumber
   module Ast
-    class Examples
-      def initialize(line, keyword, name, outline_table)
-        @keyword, @name, @outline_table = keyword, name, outline_table
+    class Examples #:nodoc:
+      def initialize(comment, line, keyword, name, outline_table)
+        @comment, @keyword, @name, @outline_table = comment, keyword, name, outline_table
       end
 
       def accept(visitor)
         return if $cucumber_interrupted
+        visitor.visit_comment(@comment) unless @comment.empty?
         visitor.visit_examples_name(@keyword, @name)
         visitor.visit_outline_table(@outline_table)
       end
@@ -20,7 +21,11 @@ module Cucumber
       end
 
       def to_sexp
-        [:examples, @keyword, @name, @outline_table.to_sexp]
+        sexp = [:examples, @keyword, @name]
+        comment = @comment.to_sexp
+        sexp += [comment] if comment
+        sexp += [@outline_table.to_sexp]
+        sexp
       end
     end
   end

data/lib/cucumber/ast/feature.rb

@@ -1,7 +1,7 @@
 module Cucumber
   module Ast
     # Represents the root node of a parsed feature.
-    class Feature
+    class Feature #:nodoc:
       attr_accessor :file, :language
       attr_writer :features
       attr_reader :name

data/lib/cucumber/ast/feature_element.rb

@@ -1,7 +1,7 @@
 require 'enumerator'
 
 module Cucumber
-  module FeatureElement
+  module FeatureElement #:nodoc:
     attr_writer :feature
 
     def attach_steps(steps)

data/lib/cucumber/ast/features.rb

@@ -1,6 +1,6 @@
 module Cucumber
   module Ast
-    class Features
+    class Features #:nodoc:
       include Enumerable
 
       attr_reader :duration

data/lib/cucumber/ast/outline_table.rb

@@ -1,6 +1,6 @@
 module Cucumber
   module Ast
-    class OutlineTable < Table
+    class OutlineTable < Table #:nodoc:
       def initialize(raw, scenario_outline)
         super(raw)
         @scenario_outline = scenario_outline
@@ -44,7 +44,7 @@ module Cucumber
         @scenario_outline.visit_scenario_name(visitor, row)
       end
 
-      class ExampleRow < Cells
+      class ExampleRow < Cells #:nodoc:
         attr_reader :scenario_outline # https://rspec.lighthouseapp.com/projects/16211/tickets/342
 
         def create_step_invocations!(scenario_outline)

data/lib/cucumber/ast/py_string.rb

@@ -16,7 +16,7 @@ module Cucumber
     #
     # Note how the indentation from the source is stripped away.
     #
-    class PyString
+    class PyString #:nodoc:
       def self.default_arg_name
         "string"
       end

data/lib/cucumber/ast/scenario.rb

@@ -2,7 +2,7 @@ require 'cucumber/ast/feature_element'
 
 module Cucumber
   module Ast
-    class Scenario
+    class Scenario #:nodoc:
       include FeatureElement
       
       attr_reader :name, :line

data/lib/cucumber/ast/scenario_outline.rb

@@ -1,9 +1,9 @@
 module Cucumber
   module Ast
-    class ScenarioOutline
+    class ScenarioOutline #:nodoc:
       include FeatureElement
 
-      module ExamplesArray
+      module ExamplesArray #:nodoc:
         def accept(visitor)
           return if $cucumber_interrupted
           each do |examples|
@@ -24,13 +24,14 @@ module Cucumber
         @steps = StepCollection.new(steps)
 
         @examples_array = example_sections.map do |example_section|
-          examples_line       = example_section[0]
-          examples_keyword    = example_section[1]
-          examples_name       = example_section[2]
-          examples_matrix     = example_section[3]
+          examples_comment    = example_section[0]
+          examples_line       = example_section[1]
+          examples_keyword    = example_section[2]
+          examples_name       = example_section[3]
+          examples_matrix     = example_section[4]
 
           examples_table = OutlineTable.new(examples_matrix, self)
-          Examples.new(examples_line, examples_keyword, examples_name, examples_table)
+          Examples.new(examples_comment, examples_line, examples_keyword, examples_name, examples_table)
         end
         @examples_array.extend(ExamplesArray)
 

data/lib/cucumber/ast/step.rb

@@ -3,7 +3,7 @@ require 'cucumber/step_match'
 
 module Cucumber
   module Ast
-    class Step
+    class Step #:nodoc:
       attr_reader :line, :keyword, :name, :multiline_arg
       attr_writer :step_collection, :options
       attr_accessor :feature_element, :exception

data/lib/cucumber/ast/step_collection.rb

@@ -1,7 +1,7 @@
 module Cucumber
   module Ast
     # Holds an Array of Step or StepDefinition
-    class StepCollection
+    class StepCollection #:nodoc:
       include Enumerable
       
       def initialize(steps)

data/lib/cucumber/ast/step_invocation.rb

@@ -2,7 +2,7 @@ require 'cucumber/step_match'
 
 module Cucumber
   module Ast
-    class StepInvocation
+    class StepInvocation #:nodoc:
       attr_writer :step_collection, :background
       attr_reader :name, :matched_cells, :status, :reported_exception
       attr_accessor :exception

data/lib/cucumber/ast/table.rb

@@ -1,11 +1,23 @@
 module Cucumber
   module Ast
-    # Holds the data of a table parsed from a feature file:
+    # Step Definitions that match a plain text Step with a multiline argument table
+    # will receive it as an instance of Table. A Table object holds the data of a 
+    # table parsed from a feature file and lets you access and manipulate the data
+    # in different ways.
     #
-    #   | a | b |
-    #   | c | d |
+    # For example:
     #
-    # This gets parsed into a Table holding the values <tt>[['a', 'b'], ['c', 'd']]</tt>
+    #   Given I have:
+    #     | a | b |
+    #     | c | d |
+    #
+    # And a matching StepDefinition:
+    #
+    #   Given /I have:/ do |table|
+    #     data = table.raw
+    #   end
+    #
+    # This will store <tt>[['a', 'b'], ['c', 'd']]</tt> in the <tt>data</tt> variable.
     #
     class Table
       include Enumerable
@@ -14,10 +26,14 @@ module Cucumber
 
       attr_accessor :file
 
-      def self.default_arg_name
+      def self.default_arg_name #:nodoc:
         "table"
       end
 
+      # Creates a new instance. +raw+ should be an Array of Array of String.
+      # You don't typically create your own Table objects - Cucumber will do
+      # it internally and pass them to your Step Definitions.
+      #
       def initialize(raw, conversion_procs = NULL_CONVERSIONS.dup)
         @cells_class = Cells
         @cell_class = Cell
@@ -28,21 +44,23 @@ module Cucumber
         @conversion_procs = conversion_procs
       end
 
-      # Creates a copy of this table, inheriting the column mappings.
+      # Creates a copy of this table, inheriting any column mappings.
+      # registered with #map_headers!
+      #
       def dup
         self.class.new(raw.dup, @conversion_procs.dup)
       end
 
       # Returns a new, transposed table. Example:
       #
-      # | a | 7 | 4 |
-      # | b | 9 | 2 |
+      #   | a | 7 | 4 |
+      #   | b | 9 | 2 |
       #
       # Gets converted into the following:
       #
-      # | a | b |
-      # | 7 | 9 |
-      # | 4 | 2 |
+      #   | a | b |
+      #   | 7 | 9 |
+      #   | 4 | 2 |
       #
       def transpose
         self.class.new(raw.transpose, @conversion_procs.dup)
@@ -109,11 +127,11 @@ module Cucumber
         raw[1..-1]
       end
 
-      def each_cells_row(&proc)
+      def each_cells_row(&proc) #:nodoc:
         cells_rows.each(&proc)
       end
 
-      def accept(visitor)
+      def accept(visitor) #:nodoc:
         return if $cucumber_interrupted
         cells_rows.each do |row|
           visitor.visit_table_row(row)
@@ -149,8 +167,10 @@ module Cucumber
       def map_headers!(mappings)
         header_cells = cell_matrix[0]
         mappings.each_pair do |pre, post|
-          header_cell = header_cells.detect{|cell| pre === cell.value}
-          header_cell.value = post
+          mapped_cells = header_cells.select{|cell| pre === cell.value}
+          raise "No headers matched #{pre.inspect}" if mapped_cells.empty?
+          raise "#{mapped_cells.length} headers matched #{pre.inspect}: #{mapped_cells.map{|c| c.value}.inspect}" if mapped_cells.length > 1
+          mapped_cells[0].value = post
           if @conversion_procs.has_key?(pre)
             @conversion_procs[post] = @conversion_procs.delete(pre)
           end
@@ -204,10 +224,10 @@ module Cucumber
       # Whether to raise or not raise can be changed by setting values in
       # +options+ to true or false:
       #
-      #   * <tt>missing_row</tt>: Raise on missing rows (defaults to true)
-      #   * <tt>surplus_row</tt>: Raise on surplus rows (defaults to true)
-      #   * <tt>missing_col</tt>: Raise on missing columns (defaults to true)
-      #   * <tt>surplus_col</tt>: Raise on surplus columns (defaults to false)
+      # * <tt>missing_row</tt> : Raise on missing rows (defaults to true)
+      # * <tt>surplus_row</tt> : Raise on surplus rows (defaults to true)
+      # * <tt>missing_col</tt> : Raise on missing columns (defaults to true)
+      # * <tt>surplus_col</tt> : Raise on surplus columns (defaults to false)
       #
       # The +other_table+ argument can be another Table, an Array of Array or
       # an Array of Hash (similar to the structure returned by #hashes).
@@ -296,11 +316,11 @@ module Cucumber
         cells_rows.index(cells)
       end
 
-      def verify_column(column_name)
+      def verify_column(column_name) #:nodoc:
         raise %{The column named "#{column_name}" does not exist} unless raw[0].include?(column_name)
       end
       
-      def verify_table_width(width)
+      def verify_table_width(width) #:nodoc:
         raise %{The table must have exactly #{width} columns} unless raw[0].size == width
       end
 
@@ -319,33 +339,33 @@ module Cucumber
         Table.new(raw_with_replaced_args)
       end
 
-      def has_text?(text)
+      def has_text?(text) #:nodoc:
         raw.flatten.compact.detect{|cell_value| cell_value.index(text)}
       end
 
-      def cells_rows
+      def cells_rows #:nodoc:
         @rows ||= cell_matrix.map do |cell_row|
           @cells_class.new(self, cell_row)
         end
       end
 
-      def headers
+      def headers #:nodoc:
         raw.first
       end
 
-      def header_cell(col)
+      def header_cell(col) #:nodoc:
         cells_rows[0][col]
       end
 
-      def cell_matrix
+      def cell_matrix #:nodoc:
         @cell_matrix
       end
 
-      def col_width(col)
+      def col_width(col) #:nodoc:
         columns[col].__send__(:width)
       end
 
-      def to_s(options = {})
+      def to_s(options = {}) #:nodoc:
         options = {:color => true, :indent => 2, :prefixes => TO_S_PREFIXES}.merge(options)
         io = StringIO.new
 
@@ -369,7 +389,7 @@ module Cucumber
 
       protected
 
-      def inspect_rows(missing_row, inserted_row)
+      def inspect_rows(missing_row, inserted_row) #:nodoc:
         missing_row.each_with_index do |missing_cell, col|
           inserted_cell = inserted_row[col]
           if(missing_cell.value != inserted_cell.value && (missing_cell.value.to_s == inserted_cell.value.to_s))
@@ -379,7 +399,7 @@ module Cucumber
         end
       end
 
-      def create_cell_matrix(raw)
+      def create_cell_matrix(raw) #:nodoc:
         @cell_matrix = raw.map do |raw_row|
           line = raw_row.line rescue -1
           raw_row.map do |raw_cell|
@@ -388,7 +408,7 @@ module Cucumber
         end
       end
 
-      def convert_columns!
+      def convert_columns! #:nodoc:
         cell_matrix.transpose.each do |col|
           conversion_proc = @conversion_procs[col[0].value]
           col[1..-1].each do |cell|
@@ -397,7 +417,7 @@ module Cucumber
         end
       end
 
-      def require_diff_lcs
+      def require_diff_lcs #:nodoc:
         begin
           require 'diff/lcs'
         rescue LoadError => e
@@ -406,23 +426,23 @@ module Cucumber
         end
       end
 
-      def clear_cache!
+      def clear_cache! #:nodoc:
         @hashes = @rows_hash = @rows = @columns = nil
       end
 
-      def columns
+      def columns #:nodoc:
         @columns ||= cell_matrix.transpose.map do |cell_row|
           @cells_class.new(self, cell_row)
         end.freeze
       end
 
-      def new_cell(raw_cell, line)
+      def new_cell(raw_cell, line) #:nodoc:
         @cell_class.new(raw_cell, self, line)
       end
 
       # Pads our own cell_matrix and returns a cell matrix of same
       # column width that can be used for diffing
-      def pad!(other_cell_matrix)
+      def pad!(other_cell_matrix) #:nodoc:
         clear_cache!
         cols = cell_matrix.transpose
         unmapped_cols = other_cell_matrix.transpose
@@ -460,38 +480,38 @@ module Cucumber
         (mapped_cols + unmapped_cols).transpose
       end
 
-      def ensure_table(table_or_array)
+      def ensure_table(table_or_array) #:nodoc:
         return table_or_array if Table === table_or_array
         table_or_array = hashes_to_array(table_or_array) if Hash === table_or_array[0]
         table_or_array = enumerable_to_array(table_or_array) unless Array == table_or_array[0]
         Table.new(table_or_array)
       end
 
-      def hashes_to_array(hashes)
+      def hashes_to_array(hashes) #:nodoc:
         header = hashes[0].keys
         [header] + hashes.map{|hash| header.map{|key| hash[key]}}
       end
 
-      def enumerable_to_array(rows)
+      def enumerable_to_array(rows) #:nodoc:
         rows.map{|row| row.map{|cell| cell}}
       end
 
-      def ensure_green!
+      def ensure_green! #:nodoc:
         each_cell{|cell| cell.status = :passed}
       end
 
-      def each_cell(&proc)
+      def each_cell(&proc) #:nodoc:
         cell_matrix.each{|row| row.each(&proc)}
       end
 
-      def mark_as_missing(col)
+      def mark_as_missing(col) #:nodoc:
         col.each do |cell|
           cell.status = :undefined
         end
       end
 
       # Represents a row of cells or columns of cells
-      class Cells
+      class Cells #:nodoc:
         include Enumerable
         attr_reader :exception
 
@@ -547,7 +567,7 @@ module Cucumber
         end
       end
 
-      class Cell
+      class Cell #:nodoc:
         attr_reader :line, :table
         attr_accessor :status, :value
 
@@ -574,7 +594,7 @@ module Cucumber
         end
       end
       
-      class SurplusCell < Cell
+      class SurplusCell < Cell #:nodoc:
         def status
           :comment
         end