Contents

= Gherkin

Fast Gherkin lexer and parser based on Ragel. Gherkin is two things:

* The language that has evolved out of the Cucumber project.
* This library

== Running RSpec and Cucumber tests

rake clean spec cucumber

If the RL_LANG environment variable is set, only the parsers for the languages specified there will be built.
E.g. in Bash, export RL_LANG="en,fr,no". This can be quite helpful when modifying the Ragel grammar.

== Release process

* Run "rake clean spec cucumber" for each platform (1.8.6, 1.8.7, 1.9, jruby) to make sure all is green.
* rvm 1.8.7
* Bump version in the VERSION file
* rake clean jar compile
* rake gemspec
* git commit -a -m "Release vX.Y.Z"
* rake gemcutter:release
* ./nativegems.sh
* gem push pkg/... (for each native gem)

== Configuring Rake-Compiler for cross compilation
In order to build Windows binaries (so we can release Windows gems from OS X/Linux) we need to set up rake-compiler.

http://github.com/luislavena/rake-compiler/

I didn't want to install macports (I'm on homebrew) and I couldn't figure out how to build MinGW myself. I got prebuilt binaries:
http://crossgcc.rts-software.org/doku.php - just add the bin folder to your PATH

== Note on Patches/Pull Requests
 
* Fork the project.
* Run rake ragel:rb to generate all the I18N lexers
* Make your feature addition or bug fix.
* Add tests for it. This is important so I don't break it in a
  future version unintentionally.
* Commit, do not mess with Rakefile, VERSION, or History.txt.
  (if you want to have your own version, that is fine but
   bump version in a commit by itself I can ignore when I pull)
* Send me a pull request. Bonus points for topic branches.

== Copyright

Copyright (c) 2009 Mike Sassak, Gregory Hnatiuk, Aslak Hellesøy. See LICENSE for details.

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
gherkin-1.0.3-i386-mswin32	README.rdoc
gherkin-1.0.3-i386-mingw32	README.rdoc