0
@@ -1,6 +1,6 @@
0
 = Gibberish
0
 
0
-Yet another localization library.  Maybe with the most agreeable API.
0
+Yet another localization library.  Maybe with the most agreeable API?
0
 
0
 = Usage
0
 
0
@@ -59,16 +59,21 @@ This of course works with your translations:
0
 
0
 Neat.  What other methods do we get?
0
 
0
-The classic around_filter use case:
0
+The classic around_filter:
0
 
0
   >> Gibberish.default_language?
0
   => true
0
   >> Gibberish.use_language(:es) do
0
+  ?>   puts "English? #{Gibberish.default_language?}"
0
   ?>   puts "hey"[:hey]
0
   >> end
0
+  English? false
0
   ¡Hey allí!
0
 
0
-So, in your ApplicationController (or somewhere):
0
+For the duration of the block, :es is set as the language of choice.  After the block is run everything
0
+returns to normal.
0
+
0
+Implement it:
0
 
0
   class ApplicationController < ActionController::Base
0
     around_filter :use_language
0
@@ -100,5 +105,20 @@ modified.  No need to reboot the server.
0
 
0
 More as it's needed.
0
 
0
+= Warning
0
+
0
+By default, Ruby returns nil when a symbol is passed to String's [] method.  Some of Rails, it seems, depends
0
+on this behavior.  Yes, I am changing !!core Ruby behavior!!  The humanity!
0
+
0
+To deal with this assumption, Gibberish has a reserved_keys array.  It, by default, contains :limit (so Rails
0
+migrations don't explode on you.)  To add to this array, just pass it more keys:
0
+
0
+  >> Gibberish.add_reserved_key :another_key
0
+  => [:limit, :another_key]
0
+  >> Gibberish.add_reserved_keys :more, :keys
0
+  => [:limit, :another_key, :more, :keys]
0
+
0
+You've been warned.  It really shouldn't affect you, though.
0
+
0
 >> Chris Wanstrath
0
 => chris[at]ozmm[dot]org

0
@@ -6,6 +6,11 @@ module Gibberish
0
     @@reserved_keys = [ :limit ]
0
     mattr_reader :reserved_keys
0
 
0
+    def add_reserved_key(*key)
0
+      (@@reserved_keys += key.flatten).uniq!
0
+    end
0
+    alias :add_reserved_keys :add_reserved_key
0
+
0
     @@languages = {}
0
     def languages
0
       @@languages.keys

0
@@ -78,6 +78,16 @@ context "After loading languages, Gibberish" do
0
     languages.should.include :es
0
     languages.should.include :fr
0
   end
0
+
0
+  specify "should be able to accept new, unique reserved keys" do
0
+    key = :something_evil
0
+    Gibberish.add_reserved_key key
0
+    Gibberish.reserved_keys.should.include key
0
+    Gibberish.reserved_keys.size.should.equal 2
0
+    Gibberish.add_reserved_key key
0
+    Gibberish.add_reserved_key key
0
+    Gibberish.reserved_keys.size.should.equal 2
0
+  end
0
 end
0
 
0
 context "When no language is set" do