Making Polyglot only load when required first. Updated docs and specs…

… to reflect this

doc/using_in_ruby.markdown

@@ -8,6 +8,13 @@ You can `.treetop` files into Ruby source code with the `tt` command line script
 ##Loading A Grammar Directly
 The Polyglot gem makes it possible to load `.treetop` or `.tt` files directly with `require`. This will invoke `Treetop.load`, which automatically compiles the grammar to Ruby and then evaluates the Ruby source. If you are getting errors in methods you define on the syntax tree, try using the command line compiler for better stack trace feedback. A better solution to this issue is in the works.
 
+In order to use Polyglot dynamic loading of `.treetop` or `.tt` files though, you need to require the Polyglot gem before you require the Treetop gem as Treetop will only create hooks into Polyglot for the treetop files if Polyglot is already loaded.  So you need to use:
+
+    require 'polyglot'
+    require 'treetop'
+
+in order to use Polyglot auto loading with Treetop in Ruby.
+
 ##Instantiating and Using Parsers
 If a grammar by the name of `Foo` is defined, the compiled Ruby source will define a `FooParser` class. To parse input, create an instance and call its `parse` method with a string. The parser will return the syntax tree of the match or `nil` if there is a failure.
 

lib/treetop.rb

@@ -12,7 +12,8 @@ module Treetop
 require File.join(TREETOP_ROOT, "runtime")
 require File.join(TREETOP_ROOT, "compiler")
 
-unless defined?(TREETOP_DISABLE_POLYGLOT)
-  require 'polyglot'
+# To have Polyglot extensions loaded, you need to require 'polyglot'
+# before you require 'treetop'
+if defined?(Polyglot)
   Polyglot.register(Treetop::VALID_GRAMMAR_EXT, Treetop)
 end

spec/spec_helper.rb

@@ -2,6 +2,7 @@
 require 'rubygems'
 require 'benchmark'
 require 'spec'
+require 'polyglot'
 
 unless $bootstrapped_gen_1_metagrammar
   load File.join(dir, '..', 'lib', 'treetop', 'bootstrap_gen_1_metagrammar.rb')