ruby--ruby/spec/README

= RubySpec

RubySpec (http://rubyspec.org) provides the Ruby langauge specification in an
executable format. The make task `update-rubyspec' retrieves the specification
and put it into this directory.

== Directory structure
 spec
  +-- mspec            driver library for executing the specification.
  +-- rubyspec
       +-- 1.8           specification for both Ruby 1.8 and 1.9
       |    +-- core        specification for core libraries 
       |    |    +-- array 
       |    |    +-- bignum
       |    |    +-- ...
       |    |
       |    +-- fixtures    example classes for writing specs
       |    +-- language    specification for Ruby language itself
       |    +-- library     specification for standard libraries
       |         +-- addrev
       |         +-- ...
       |    +-- core
       |    +-- ...
       |
       +-- 1.9           specification for new features and large changes in Ruby 1.9
            +-- core
            +-- fixtures
            +-- language
            +-- library
            +-- core
            +-- ...

== How to run
:make target
  verifies all specs.
   $ make test-rubyspec
:mspec command
  verifies the specified spec.
   $ mspec spec/path/to/some_spec.rb